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PREFACE 



The MP Micro ASSembler (MASS) is a component of the MP-60 Software 
package. It is intended to assemble microcode for the CDC Micropro- 
grammable Processor, herein called the MP. The assembler operates under 
control of the CYBER 170/70L/6000 NOS/BE 1.0 Operating System and the 
CYBER 170/70L/6000 NOS 1.0 Operating System. A separate version of the 
MP Micro Assembler executes on the MP-60 Series computer. 

%Ji This assembler manual is to be used in conjunction with the Basic System 

Controller Model 65109 Hardware Reference Manual (see list of publications 

\J) below) . This manual will describe the general operation of the assembler 

and provide necessary instruction for preparing programs for assembly. 

\J) No attempt is made here to provide a programmer's guide; therefore, 

examples will be limited. It is assumed that the reader is already 

C familiar with the operation of the MP computer. A detailed description 
of the MP computer may be found in the above-mentioned Basic System 
Controller Model 65109 Hardware Reference Manual. 



Following is a list of related manuals: 

Manuals CDC Publication No. 



NOS 1.0 Reference Manual Vol. I 60435400 

NOS 1.0 Reference Manual Vol. II 60445300 

NOS/BE 1.0 Reference Manual 60493800 

Basic System Controller Model 65109 41618400 
Hardware Reference Manual 

This product is intended for use only as described in this document. 
Control Data cannot be responsible for the proper functioning of 
undescribed features or undefined parameters. 
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INTRODUCTION 



\£ The assembler for the CONTROL DATA Microprogrammable Processors provides 

the mnemonic language necessary for the programmer to writ© a microprogram. 

^J) The assembler translates symbolic source program instructions into object 
machine instructions and provides a listing of assembly results. 

© 

The characteristics of the assembler as written for the CYBER 170/70L/6000 
\J; and MP-60 Series computers are described. This assembler is based on the 

MICROTI assembler for the MPP computer. 



Input to this assembler consists of one or more source programs followed by 
a FINIS card. Each program begins with an IDENT card and is terminated with 
an END pard. Each program is coded using these basic elements: 

Symbols 
Constants 

Pseudo Instructions 
* Mnemonic Instructions 

Thp bgsic elements are punched into a card in specific fields, always leffr- 
justified within the field. 

Output from the assembler consists of the following: 



Assembly listing including diagnostics 

Zero location map 

Deadstart object time 

User generate micro binary I 
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LANGUAGE STRUCTURE 



|^ STATEMENT FORMAT 

A source input statement to the MP assembler (MASS) consists of 11 
f\ fields, as contained in Table 2-1 and as illustrated in the coding form 

depicted in Figure 2-1. Of these fields, the Q (qualifier), location, 
^J) and comment fields are used to improve the documentation of the assembled 

microinstructions, while the remaining eight fields correspond to the 
^J eight fields of the MP microinstruction shown in the Basic System Controller 

Model 65109 Hardware Reference Manual. The eight fields used op the 
^J! input form are in the same order that the programmer will tend to use in 

preparing microinstructions for a microprogram. 

Information entered in each field (if anything is entered) is entered 
g«* left-justified with blank fill. Information which is not entered left- 

justified will not be processed correctly by the assembler. 

Q FIELD 

The Q field is column 1 of the input coding form. This field may contain 
an asterisk (*), dollar sign ($), plus sign (+) , minus sign (-) , or it 
may be blank. 



(J, An asterisk (*) or dollar sign ($) specifies that the rest of the input 

source statement is a remark and that the remaining 79 columns contain 

^J comments. This qualifier allows the remarks card to be printed on the 

listing with no effect on the assembler object code output. One line is 

^1 skipped before and after a single comment card or group of comment cards. 

£| A plus sign (+) in the Q field locates the resulting microinstruction as 
the upper instruction of a microinstruction pair. 



A minus sign (-) in the Q field locates the resulting microinstruction 
as the lower instruction of a microinstruction pair. 



A blank in the Q field locates the resulting microinstruction in the 
^} next available half of a microinstruction pair. 

{) 17328900-02 
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FIELDS 



Location 



(function) 



A 
B 
D 



(constant) 



M 



T 
(test) 



Comment 



TABLE 2-1. SOURCE STATEMENT FIELDS 



COLUMNS 



2 through 9 



11 through 16 



17 through 22 
23 through 28 
29 through 34 

35 through 40 



41 through 49 



50 



51 through 55 



56 through 80 



COMMENTS 



2-2 



The qualifier field may specify 
whether the (qualifier) statement is 
a comment, an upper instruction, or 
lower instruction. 

The location field specifies the 
statement's symbolic address in this 
program. 

The function field specifies a logical, 
arithmetic, shift or scale operation that is 
performed by the arithmetic and logic unit ? 
(ALU) on two sources and placed in a 
destination. 

Specifies the A source of the function. 

Specifies the B source of the function. 

Specifies the destination of the result 
of the ALU. 

The special field provides special instruc- 
tion modes that either: 

• Extend the A, B, and D fields, or 

• provide a special command which is 
performed in parallel with the data 
transfers taking place in the ALU. 

The constant field specifies another special 
command that is performed independently of 
the rest of the instruction; it is executed 
in parallel with the rest of the instruction. 

The mode field specifies the addressing 
method for obtaining the next instruction 
pair: .sequential, jump or return. 

The test field is the conditional branch of 
the instruction and specifies which instruc- 
tion (upper or lower) of the next instruction 
pair to execute. The test and branch are 
executed after the rest of the instruction 
has executed. 

The comment field is used for remarks that 
are printed as part of the list output. 
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Each micromemory location (address) contains space for two microinstruc- 
tions. These are referred to as the upper and the lower microinstruction. 
If column 1 is blank, the statement is assigned to the next available 
microinstruction position (either upper or lower). If column 1 contains 
a plus (+) sign or any character other than .-, $, *, or blank, that 
statement is assigned to the next available upper microinstruction 
location. If column 1 contains a minus (-) sign, that statement is 
assigned to the next available lower microinstruction location. The use 
of + and - results in possibly skipping an available microinstruction 
location. The skipped location is assembled as all zeros and not listed „^ 

on the listing. ^y 

LOCATION FIELD \y 



- + - * / blank 



o 
o 
o 

o 






v_ 



The location field is in columns 2 through 9 of the input coding form. 
This field may be left blank or it may contain a symbol. If a symbol is 
included in the field, it must be entered left-justified and follow the 
definition of a symbol. 

A symbol in the location field is assigned the value of the location of 

the corresponding microinstruction or constant, or the value of the ^""^ 

expression starting in columns 17 with a SET or EQU pseudo instruction. 

A symbol in the location field of a microinstruction takes on the upper/lower ^ 
quality of the actual microinstruction location. This quality is used ^ 

in coding jumps in the C field of a microinstruction. ^-> 

SYMBOLS C 

A symbol is a set of characters that identifies a value and its associated |"> 
qualities. A symbol can be a maximum of eight characters. A symbol 

must contain a non-numeric character to distinguish it from a constant. /«f> 

A symbol cannot include the following characters: 
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The process of associating a symbol with a value and qualities is known 
■ J as symbol definition. This can occur in two ways: 

1. A symbol used in the location field (columns 2 through 9) of a 
symbolic machine instruction or certain pseudo instructions is 
defined as an address having the current value of the location 
counter and having an upper or lower quality. 



© 

O 

O 
© 

© 



2. A symbol used in the location field of definition pseudo 

instructions EQU and SET is defined as having the value and 
quality derived from an expression starting in column 17 of 
the instruction. The SET pseudo instruction assigns an attribute 
of redefinability to a symbol. Unless a symbol was previously 
defined with a SET instruction, a second attempt to define it 
with a different value produces a duplicate definition fatal 
error flag. 

■T) A symbol may be used in the location field (columns 2 through 9), the S 
field (columns 35 through 40), or in the C field (columns 41 through 49) 
of a microinstruction on the input form. 

A symbol is undefined when it has never appeared in the location field, or 
if it is equated to an undefined symbol. The assembler identifies the use 
WW of undefined symbols on the assembly listing. 



Examples: 

HCNYL Legal 

TAG Legal 

1234 Illegal (will be interpreted as a constant) 

*12.3 Illegal (contains an asterisk) 

XYZ/3P Illegal (contains a slash) 

B=3 Illegal (contains an equal sign) 



© 

© 

© 

CONSTANTS 



Constants are used to represent numbers and may be used in the S and C 
fields of the input form. Constants may also be used on the right side 



o 
o 

© 17328900-02 2 "? 



o 



of the several pseudo instructions. The MP assembler recognizes three 
types of numeric constants: decimal, octal and hexadecimal. Decimal 
constants have no suffix, octal constants have B as a suffix, and hexadecimal 
constants have X as a suffix. The numeric constant is represented by a 
string of digits within the number base of the constant and is always a 
whole integer number. Constants must fit in the field's length except with the 
VFD pseudo. 

DECIMAL CONSTANTS 

A decimal constant consists of a string of decimal digits. If the 
constant is larger than the field width within the microinstruction, the 
high order bits will be discarded. 

Examples : 

999 Legal 

98A Illegal (contains an alphabetic character) 

12. 1 Illegal (contains a decimal point) 

OCTAL CONSTANTS 

An octal constant consists of a string of octal digits that are suffixed 
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with the letter B. „*-% 

Examples ; *~\ 

123B Legal 

77B Legal ^ 

01 9B Illegal (contains a non-octal digit) 

HEXADECIMAL CONSTANTS 

A hexadecimal constant consists of a string of hexadecimal digits and is 
suffixed with the letter X. The hexadecimal digits are 0, 1, 2, 3, 4, 
5, 6, 7, 8, 9, A, B, C, D, E, and F. 
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Examples : 

77BX Legal 

1GX Illegal (contains a non-hexadecimal digit) 

ABC Illegal (has no X suffix) 

77B Will be interpreted as an octal 77 

PSEUDO INSTRUCTIONS 

Pseudo instructions direct the MP assembler to perform specific functions. 
They do not generate MP instructions. They define assembler control, 
listing control, data definition, and other operations. Pseudo instructions 
are defined in Section 3 of this manual. 

MNEMONIC INSTRUCTIONS 

Mnemonic instructions allow the programmer to use convenient names to 
specify the binary information* to be inserted in each field of MP micro- 
instruction. The list of mnemonic instructions recognized by the MP 
assembler for each field of the instruction is given in Table 2-2. 
Detailed usage of the mnemonic instructions is given in Section 4 of 
this manual . 

Also allowed are user definable opcodes that can be used in place of the 
assembler opcodes. MASS will try to match the opcodes first from the symbol 
table and then from the opcode set in MASS. 

Whether or not a user-defined opcode is illegal or not is dependent on which 
field the opcode is to be used. Each field has associated with it a mask to 
define the bit fields. The masks for the fields are shown as follows: 
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FIELD MASK 

M C0001FFF 

F 3FFF0000 

A OICOOFOO 

B 00380FFF 

D 00070FOO 

T 0000E08F 

S OOOOOFOO 

C COOOIOFF 

The user-defined opcode is usually established with an EQU and the bits must 
fit within the mask or an error will result. 

Example: ROTE EQU 11110000X -- legal only in the F Field 



O 

A 
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PSEUDO INSTRUCTIONS 



Pseudo instructions are instructions to the MP assembler and normally do 
not result in any microcode output (the only exceptions are the HEX, 
DEC, OCT and VFD pseudo instructions) . A pseudo instruction consists of 
the pseudo operation code, which is coded in the F field of the input 
form (columns 11 through 16), plus additional information coded in the 
other fields of the input form. The detailed field usage is given under 
each pseudo instruction. 

ASSEMBLER CONTROL 

These pseudo instructions define and control the operation of the MP 
assembler, but do not generate code in the object program. 



© IDENT 



This pseudo instruction provides program identification and must be used 
as the first instruction of each program. Text in columns 17 through 71 
of the IDENT card is printed as the first line at the top of each page 
of the output listing. The location field is ignored. 

Example : 



11 



IDENT 



17 



CDC 844 DISK FILE CONTROLLER EMULATION FOR MP 



TITLE 



^% This pseudo instruction provides page heading information and may be 

used anywhere in the program. The TITLE pseudo causes a page eject and 

^M a new heading to be printed at the top of the page. This heading consists 

of columns 17 through 23 from the IDENT card, followed by one space and 

flp the contents of columns 17 through 63 from the TITLE card. 
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Example : 






11 

TITLE 



n m 

DISK FILE CONTROLLER EMULATION FOR MP 



END 

The END pseudo instruction signals the end of this program for assembly 
and must be the last instruction in a program. It causes the assembler to 
proceed with the 'complete assembly' process. On completion of the assembly 
process, the assembler is reset and continues reading input information to 
Obtain the next microprogram of a batch to assemble. The total assembly 
process is completed on detecting a FINIS pseudo instruction. 



Example : 



11 



o 

o 

i 

o 



END 









FINIS 

The FINIS pseudo instruction signals the completion of a batch of assemblies 
by the MP assembler and returns control to the host computer operating 
system. The MP assembler accepts the FINIS pseudo instruction in either 
columns 10 or 11. 

Examples (either of the following) : 



10 



11 



FINIS 
FINIS 









OPTN 

The OPTN pseudo instruction informs MASS of the control and input/output 
options for this assembly. The OPTN pseudo instruction may appear 
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■ J anywhere in the program. The requested options are separated by commas 

with the first blank or column 50 terminating the scan. Most of the 
fj options once set remain in effect for the complete assembly and, therefore, 
more than one OPTN pseudo can be specified. Only the first character is 

■ J used to determine the requested option (L and LIST are equivalent option 

requests). Any illegal options are flagged as errors and ignored. 
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The following options may be specified by the OPTN pseudo: 

C The C (CROSS) option requests a cross-reference listing on the 
list file (OUTPUT). 



D The D (DEAD) option requests a deadstart format file on the 
object file (PUNCH). 

M The M (MAP) option requests a listing of unused (zero) micro- 
f^, memory locations on the list file (OUTPUT). This option is 

available only if either deadstart or simulate output is 
■ J) requested. 

N The N (NOSUM) option requests that no checksums of micromemory 
be generated. If the checksum is generated, the result is 
an exclusive OR of all of micromemory and is stored in the 
first (lowest) available unused (zero) micromemory location. 



The S (SIMULATE) option requests that a binary file of micro- 
memory, file 1, file 2 and the symbol table be written on the 
simulation object output file (SIMFIL for input by the MP 
Simulator (MPSIM) . 



M% L,L=xx The L (LIST) option requests a listing on the list file 

(OUTPUT). If the L=xx option is used, and the xx is not equal 
m% to 61, no further output listing is produced. 

I The I (INPUT) option requests from a file named INPUT. 



The default options are L and I. File names in parenthesis are defaults. 

Example: 

11 17 

OPTN CROSS, DEAD, LI ST, INPUT 
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FILE 

The FILE pseudo is used to place constants in file registers 1 or 2. 
Card column 17 contains either 1 (or blank) or 2 to specify which 
register file the succeeding constants go into. The FILE pseudo is used 
to create constants for loading into the file registers and may appear 
anywhere in the program. 

Example : 



11 



FILE 
FILE 
FILE 



17 



Assumes file 1 



ENDF 

The ENDF pseudo is used to terminate the assembly of instructions into 
the register file areas. 

Example : 

11 



ENDF 



LISTING CONTROL 

The listing output for the MP assembler is controlled by the following 
pseudo instructions. These pseudo instructions may appear anywhere in the 
source input between IDENT and END pseudo instructions. 
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EJECT 



The EJECT pseudo instruction causes the listing to eject to the top of 
the next page and start a new page. The EJECT pseudo instruction card 
is not printed. 



Example : 



11 



EJECT 



SPACE 

The SPACE pseudo instruction causes blank lines to be printed. The 
SPACE pseudo instruction is not printed. The number of blank lines to 
be listed is defined in the A field of the pseudo instruction. The A 
field may contain a constant or a predefined symbol. 

Example : 





2 


11 


17 




NUMBER 


EQU 


2 




SPACE 


6 






SPACE 


NUMBER 



The first SPACE pseudo instruction would cause six blank lines to be 
printed. The second would cause two lines to be printed if NUMBER has 
been defined to be 2 by an EQU or SET pseudo instruction. 



BOX 



This pseudo instruction is used in conjunction with EBOX to provide 
emphasis for comments in the listing. This pseudo instruction is not 
printed; instead, a line of asterisks will be listed. All succeeding 
cards will have asterisks in columns 1 and 80 to create comment cards. 
Only an EBOX or END pseudo instruction following a BOX pseudo instruction 
will be executed. The listing will be spaced one line before printing 
the first line of asterisks for the BOX command. 
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NOTE 

A BOX command will turn all succeeding micro- 
instructions to comment cards until EBOX is 
encountered. 



Example : 



11 



17 



BOX 



EBOX 

This pseudo instruction causes a line of asterisks to be listed rather 
than this pseudo instruction. In addition, the automatic assignment of 
asterisks to columns 1 and 80 started by the BOX pseudo instruction will 
be terminated. One blank line will be listed after the line of asterisks. 



Example : 



11 



17 



o 
o 
o 



o 









^Ly 



EBOX 



NOLIST 

The NOLIST pseudo stops further listing until a LIST or END pseudo is 
encountered, except for cards which cause diagnostics. 



Example : 



11 



17 



NOLIST 



LIST 

The LIST pseudo starts listing after being stopped by the NOLIST pseudo. 



Example : 



11 



17 



LIST 



V. 



V-> 



_y 



\_y 



x.,„y 



4' 
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REM 



jff The REM pseudo is another way to create comments. The entire card is 

considered a comment card except there is no automatic line space before 
Q the REM card, or after unless it immediately follows a comment card. 



Example : 



1 



THIS 



11 



REM 



17 



IS A COMMENT 



© MEMORY MANAGEMENT AND SYMBOL DEFINITION 

© 



These pseudo instructions define symbols and provide for controlling the 
allocation of micromemory for the object code output. 

The EQU, SET, VFD, continuals and ORG pseudo instructions require an 
address expression that begins in card column 17 and may continue through 
column 50. The expressions are made up of operands separated by operators. 
The operands may be constants, asterisks or previously defined symbols. 
The operators are +, -, * and / (add, subtract, multiply and divide). 
Expressions are evaluated from left to right; there is no hierarchy of 
operators. Parentheses are not allowed for grouping within an expression. 
The expression terminates on the first blank character. The results of 
the expression and any intermediate computations are truncated integers 
within the range of the host processor; for each EQU and SET, the range is 
to 2 20 (19 bits). 

Example : 



f% A-B/C*D+E Legal (if A=8, B=3, C=4, D=6, E=3, value is 9) 

F Legal 

4fc * Legal (current location counter) 

**5 Legal (current location counter times 5) 

tf| *+5 Legal (current location counter + 5) 
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All micromemory and file register definitions are defined as 2*value. Ip. 
an expression, the micromemory/ file register definitions are adjusted during 
multiplication and division. 

Note that symbols for file and memory locations are stored in the symbol table 
at twice the memory location, if upper of the microinstruction pair, and twice 
the memory location, plus 1, if lower of the microinstruction pair. Symbols 
for file locations are always twice the file location. This implies that if 
the label "STUFF" is associated with micromemory location 00C upper, then the 
instruction LABEL EQU STUFF+5 would generate a hexadecimal 11 for LABEL. If 
the EQU was changed to ORG, then LABEL would be associated with Oil upper (not 
00E lower). 

Any symbol appearing as an operand in the expression of an EQU, SET, ORG 
instruction must have appeared and been defined in the location field 
prior to its use in the expression. 

EQU 

The EQU pseudo instruction assigns a value corresponding to the expression 
beginning in column 17 to the symbol appearing in the location field 
(columns 2 through 9) . The symbol in the location field of a micromemory 
location or file takes on an upper or lower quality matching that of the 
expression in the A field. The use of the qualifier field in column 1 of 
an EQU card has no effect on the quality of the symbol defined by the 
equate operation. 

Example : 

2 



VALUE 
LABEL 
LABEL. 1 
P.43X 
LOCATE 





11 


17 




EQU 


4 




EQU 


VALUE*VALUE/2 




EQU 


LABEL+1*2 




EQU 


VALUE/ 3 




EQU 


* 



VALUE = 4 

LABEL * 8 

LABEL. 1 =18 

P.43X-1 

LOCATE = current location counter 



o 
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SET 

The SET pseudo instruction assigns a value corresponding to the expression 
beginning in column 17 to the symbol appearing in the location field. 
The symbol in the location field takes on an upper or lower quality 
matching that of the expression in the A field. The use of qualifier 
field (column 1) has no effect on the upper or lower quality of the 
symbol. Unlike the EQU pseudo, a symbol defined by a SET pseudo may be 
redefined by a later SET. A symbol defined by SET may not appear in the 
location field of an EQU pseudo. 

Examples : 



VALUE = 4 

LABEL =8 

LABEL =18 

P.43X = 1 

LOCATE = current location counter 

LOCATE = current location counter +5 





2 


11 


17 




VALUE 


SET 


4 




LABEL 


SET 


VALUE*VALUE/2 




LABEL 


SET 


LABEL+1*2 




P.43X 


SET 


VALUE/ 3 




LOCATE 


SET 


* 




LOCATE 


SET 


*+5 



ORG 



o 



o 
o 
© 



The ORG pseudo instruction is used to assign a starting value to the 
micromemory location counter, The micromemory location counter provides 
for automatic allocation of microinstructions to successive upper and 
lower locations, unless the allocation is changed by the coding of a 
plus sign or minus sign in column 1 of the microinstruction input card. 
When ORG is encountered, all instructions and data following the ORG 
pseudo instruction are assembled in consecutive upper and lower micromemory 
locations, starting with the upper location of the address specified by 
the expression beginning in column 17. The ORG may be used as many times 
as desired. If use of the ORG pseudo instruction causes some instruction 
to be assembled into a non-zero location (i.e., assembly over an already 
assembled location), an error is flagged and the number of the card that 
previously caused the location to be assembled is printed for cross- 
reference. The most recent instruction does, however, overlay the 
previously assembled instruction. 
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Examples: 





11 


17 




ORG 


100+ABC 




ORG 


FF3X 




ORG 


TAG 



Set program location counter to upper 

of 150 decimal if ABC = 50. 

Set program location counter to upper 



of FF3 



16 



Set program location counter to the 
value TAG (provided TAG is defined). 



DATA DEFINITION 



Three data definition pseudo instructions are provided so the programmer 
can define 32-<-bit constants to be inserted in the micromemory at the 
current location specified by the micromemory location counter. The 
pseudo commands are DEC, OCT and HEX for decimal, octal and hexadecimal 
constant generation. The pseudo commands are coded in the F field of 
the coding form, and a string of digits in the number base is included 
in columns 17 through 28. Comments may start in any column after 29. 
The string of digits may include a minus sign (-) . Embedded blanks are 
ignored. The string of digits is converted in its number base to a 32- 
bit binary number. The result is complemented (one's complement) if a 
minus sign exists anywhere in the string. A symbol may be placed in the 
location field for referencing the constant, and the qualifier field may 
have a plus, a minus or a blank to control the micromemory allocation. 

An error is indicated if the string of digits contains any digit not in 
the number base. 



OCT 



The OCT pseudo instruction causes the string of digits starting in 
column 17 to be converted from octal representation to binary and stored 
at the current micromemory location. A symbol in the location field is 
optional. Occurrence of any character other than through 7 or minus 
in the string will cause an error to be indicated. The string is 
terminated by a blank. 



o 
o 
o 
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Example: 



11 

OCT 

OCT 



1_7 

123 
-123 



Create 00000000123g in the current location 
Create 37777777654g in the current location 



DEC 



The DEC pseudo instruction causes the string of decimal digits in 
columns 17 through 28 to be converted from decimal representation to 
binary and stored as a 32-bit number in the current micromemory location. 
A symbol in the location field is optional. Occurrence of any character, 
other than through 9, or minus in the string, will cause an error to 
be indicated. The string is terminated by the first blank. 

Example: 



Create 0000000A (hex) in the current location. 
Create FFFFFFF5 (hex) in the current location. 





11 


17 




DEC 


10 




DEC 


-10 



HEX 



© 



o 

o 




The HEX pseudo instruction causes the string of hexadecimal digits in 
columns 17 through 28 to be converted from hexadecimal to binary repre- 
sentation and stored as a 32-bit number in the current micromemory 
location. A symbol in the location field is optional. Occurrence of 
any character other than through 9, A through F or minus in the string 
will cause an error to be indicated. The string is terminated by the 
first blank. 

Example: 



11 



HEX 
HEX 



17 



DEAD 
DEAD- 



Create 0000DEAD (hex) in the current location. 
Create FFFF2152 (hex) in the current location. 
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VFD 



The VFD pseudo instruction is used to create specific bit patterns 
within a micromemory word. 

The VFD pseudo generates one word (32-bits) from one or more specifications 
in columns 17 through 50. The format of the instruction is: 



VFD 
where 



Sj,nij »S2>m'2» 



s n' m n 



s- is the number of bits of the value of ni£ to be 

included in the word, and 
m- is an expression. 

The sum of the s^s must equal 32. If the number of bits necessary to 
contain the value of an expression is less than the corresponding size 
s, the value is right-justified with zero fill. If the number of bits 
is larger than the size s, bits are truncated from the left. 



o 
o 
o 

o 

o 



A 



w 



\_J' 



Like the EQU, SET, ORG pseudo instructions, any symbol appearing as an 
operand in ah expression MUST have been defined in the location field 
prior to its use in the instruction. 



Example : 

Result 



E0A0A803 
00000008 
FFFFFFFB 
00007000 



11 



17 



EQU 


10 


ORG 


8 


VFD 


4,-2,8,4,2,X,6,X+2,l,l,ll,*-5 


VFD 


32,X 


VFD 


32,-5 


VFD 


16,0,4,7,12,0 



PROGRAMMING INFORMATION 

The programming information pseudo instructions provide the programmer with 
additional information in the output listing. 
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The MASS analyzes each microinsruction for its execution time in the variable 
cycle length of the MP. This timing information is printed immediately 
preceding the first column of the card listing on the assembler printout. 
This timing is represented in a cycle count of the 56 nanosecond basic cycle 
time of the MP. The following pseudo instructions allow the programmer to 
notify the assembler of the mode of operation for timing purposes. 

If no timing pseudo instructions are used, the assembler assumes two's 
complement operation. In addition, some instructions take a different 
amount of time to execute, depending on whether they are executed on a 
16- or 32-bit machine. See the Basic System Controller Model 65109 Hard- 
ware Reference Manual for these differences. 



CMP1 



The CMP1 pseudo instruction causes the timing information following the 
pseudo instruction to be listed for each instruction as if the MP were 
operating in the one's complement mode. CMP1 may be used anywhere and as 
often as desired in a program. 



CMP2 



The CMP2 pseudo instruction causes the timing information following the 
pseudo instruction to be listed for each instruction as if the MP were 
operating in the two's complement mode. CMP2 may be used anywhere and as 
often as desired in a program. 

CONDITIONALS 

Instructions in a program can be skipped or assembled according to the 
value of a symbol or expression at assembly time by the use of condi- 
tionals. In the following conditional pseudos, m is the symbol or 
expression to be evaluated; any symbols used must be previously defined. 
The tag is a symbol and is optional; if used, it is separated from m 
by a comma. 
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All instructions following the conditional pseudo instruction are assembled 
when the test condition is true and skipped when the condition is false. 
Skipping is terminated either by the matching ENDIF.pr an END -pseudo. 
One blank line is output on the listing before each conditional. 

ENDIF 

This pseudo is used to terminate the conditional skipping of code to be 
assembled; otherwise, it has no effect. If there is no tag in the loca- 
tion field, any skipping in effect is terminated. If a tag appears in 
the location field, only the conditional(s) which specify that tag will 
be terminated. One blank line is skipped after an ENDIF. 

Format : 

2 



tag 



11 



ENDIF 



17 



IZD 



IZD causes the coding lines following the IZD pseudo to be assembled 
only if the value of m is zero. 



Format : 



IND 



11 



IZD 



17 



m,tag 



IND causes the coding following the IND to be assembled only if the 
value of m is not zero. 



Format : 



11 



IND 



17 



m,tag 



IGD 



IGD causes the coding following the IGD to be assembled only if the 
value of m is greater than or equal to zero. 



Format : 



11 



IGD 



17 



m,tag 
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ILD 

ILD causes the coding following the ILD to be assembled only if; the value 
of m is less than zero. 



Format : 



ill 



ILD 



Example of Conditional: 



XYZ 
JKL 
PQR 



DWD 



ART 

BUFF 



11 



EQU 
EQU 
EQU 
IZD 



END IF 
EQU 
ORG 
IGD 



ENDIF 



17 



m,tag 



17 



1 



-1 

XYZ , DWD 

Code Not Assembled 



ENDIF 




IGD 

• 


XYZ, ART 


• 


Code Assembled 


IND 

• 


XYZ, ART 


• 


Code Assembled 


ILD 


JKL-XYZ.ART 



Code Not Assembled 

Terminates the IGD, IND and ILD 

* 

BUFF+X 
*-BUFF-30 

Code not assembled if value 
of X is greater than 29. 
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All instructions of the MP may be coded in the MASS language using 
mnemonic codes and symbolic programming techniques. This section describes 
how machine language microinstructions are expressed in MASS and the 
relevant requirements and limitations. 

NIP MACHINE ORGANIZATION 

Figure 4-1. gives the organization of the registers and the ALU in the 
MP, including transforms. 

MICROINSTRUCTION FORMATS 

Figure 4-2. shows the format of the microinstructions for the MP. Each 
microinstruction is 32 bits in length. The micromemory is organized 
into 64-bit micromemory locations; each location contains two micro- 
instructions , an upper microinstruction and a lower microinstruction. 
The determination of which microinstruction of a pair to execute is 
specified by the T (test) field of the previously executed microinstruc- 
tion. 

Each microinstruction consists of five major divisions: 

* M field, which specifies the mode of selecting the next micro- 
instruction pair and also selects different formats for inter- 
pretation of the S and C fields of the microinstruction. 

* ALU control, which consists of the F, A, B and D fields; these 
fields specify two sources, a destination and an ALU operation 
to be performed. ALU control may be included in all microin- 
structions. 
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T field, which specifies a condition to be tested in selecting the g^ 

upper or lower of the next microinstruction pair for execution. 

The T field may also specify an unconditional selection. |-| 

S field, which specifies a special operation to be executed in ^ 

parallel with ALU control, a page for a microinstruction jump 

or transform, or extension of the A, B and/or D field coding. ^ 



C field which specifies additional operations to take place AA 

in parallel with other operations, a jump address, or a 

constant for transfer to the N or K register. ,*->, 



The six microinstruction formats in Figure 4-2. are selected based on 
the information coded in the M and C fields of the input form. In all 
cases, the ALU control portion of the microinstruction may be coded 
regardless of the format selected. Basic test conditions may be coded 
in all formats; extended tests may only be coded in format 1. 

F FIELD 

The F field specifies either ALU operations on the output of selector 1 and 
selector 2 (the A field and the B field respectively), or shift/scale 
operations in the A or AQ registers. In the case of shift and scale 
operations, the' A and B fields of the microinstruction must not be specified, 

ALU OPERATIONS 






\^y 



/f~\ 



'i_y 



The ALU operations are either logical or arithmetic, and combine two source 

inputs. The result is routed to a single destination. The two inputs are q 

called the A source and the B source. The A source is referred to as the A 

input or selector 1 (Si) and the B source as the B input or selectpr 2 (S2). 
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LOGICAL OPERATIONS 

The logical operations perform bit-by-bit combinations of the A input 
and B input for delivery to the destination. An example of the use of 
the logical operations is shown in Figure 4-3. 



Assume: 



F Code 



11 
10 1 



A input bit values 
B input bit values 



Bit Results of 
the Operation 



ZERO 











A.B 








1 


A.-B 








1 


A 








1 1 


-A.-B 





1 





B 





1 


1 


EOR 





1 


1 


A+B 





1 


1 1 


-A.-B 


1 








-EOR 


1 





1 


-B 


1 





1 


A+-B 


1 





1 1 


-A 


1 


1 





-A+B 


1 


1 


1 


-A+-B 


1 


1 


1 


ONE 


1 


1 


1 1 



Operation 

Zeros output 

Logical product of A and B 

Logical product of A and not B 

Transfer A 

Logical product of not A and B 

Transfer B 

EXCLUSIVE OR of A and B 

INCLUSIVE OR of A and B 

Logical product of not A and not B 

Negation of EXCLUSIVE OR of A and B 

Transfer one's complement of B 

INCLUSIVE OR of A and not B 

Transfer one's complement of A 

INCLUSIVE OR of n?t A and B 

INCLUSIVE OR of not A and not B 

One ' s output 



ARITHMETIC OPERATIONS 



© 



The arithmetic operations of addition and subtraction are specified in this 
set of F codes. Two options are provided. The first option provides an 
arithmetic overflow test if the letter T is included in the F code. This 
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A 



sets the overflow capture bit on the transform logic if an add or subtract 
operation generates an arithmetic overflow. The overflow condition exists if 
the signs of the A source and B source are the same and the, sign of the 
result is different (addition), or if the signs of the A and B sources differ 
and the sign of the result is the same as the B source (subtraction). An 
example of an overflow condition is shown in Figure 4-4. 

The second option provides for a forced carry into the ALU logic unit, 
coded as a +. This option is used to emulate multiple-precision arithmetic. 

The arithmetic operations are performed in one's or two's complement 
arithmetic and can operate on single-precision operands using the main 
ALU. Selection of one's complement or two's complement mode (SM101)* is 
explained in the Basic System Controller Model 65109 Reference Manual. 

The arithmetic cbdes are as follows: 



F Code 



SUB 



ADD 



SUBT 



ADDT 



SUB- 



Qperation 
Subtract B input from A input. 

Add A and B inputs. 

SUB with overflow test. 

ADD with overflow test. 

SUB with forced carry-in (generally the same as a 
SUB). 



*SM100 means status/mode register 1, bit position 00. B^.t positions are 
numbered from left to right, with 00 as the left-most bit. 
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F Code 



ADD+ 



SUB-T 



ADD+T 



A- 



A-T 



A+ 



A+T 



Operation 

ADD with forced carry-in (A+B+l for two's complement; 
A+B+l for one's complement if both numbers are posi- 
tive; otherwise, A+B for one's complement if one 
number is negative) . 

SUB- with overflow test. 

Add+ with overflow test. 

Subtract 1 from A input. 

Subtract 1 from A with overflow test. 

Add 1 to A. 

Add 1 to A with overflow test. 
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SHIFT OPERATIONS 

Sh,ift operations shift the A or the AQ register left (L) or right (R) 
the number of bit positions specified by the contents of the N register. 
Additional shift modifier postfixes are as follows: 
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OE 



IE 



SE 



EA 



Enter zero (right or left) for each shift cycle. 

Enter one (right or left) for each shift cycle. 

Extend initial value of bit for each shift 
cycle. 

Perform end-around shift. 
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The number of bits shifted is determined by the count in N at the start 
of the shift instruction. If the N register is zero, no shift occurs. 
The N register can be set in the (same) instruction by placing N=value 
in the C field; the value set affects the following instruction. The 
shift operations are various combinations of shift A or A/Q, left or 
right, end-around or end-off, sign-extended or not sign-extended and 
entry of a to 1 in the vacated bit position. The A, B and D fields 
must be left blank. 

An example of the shift operation is shown in Figure 4-5. 

The shift operation is coded as the F field mnemonic. The D field of 
the microinstruction normally should be left blank to generate a NOP 
because the shift is performed in the A or AQ register without use of 
the ALU. The shift options are coded in the A and B fields of the 
microinstruction, and these fields of the coding form must be left 
blank. 

The legal shift mnemonics using the above codes are as follows: 

F Code Operation 

AROE Shift A right with zero entry. 

ARSE Shift A right with sign extended. 

AREA Shift A right, end-around. 
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F Code 

ALOE 

AL1E 

ALEA 

AQROE 

AQRSE 

AQREA 

AQLOE 

AQLEA 



Operation 

Shift A left with entry. 
Shift A left with 1 entry. 
Shift A left, end-around. 
Shift AQ right with entry. 
Shift AQ right with sign extended. 
Shift AQ right, end-around. 
Shift AQ left with entry. 
Shift AQ left, end-around. 



SCALE OPERATIONS 

Scale operations are similar to shift operations but are conditioned by 
the two bits at the scale point being different. Scale examines N. If 
N = 0, the scale operation is terminated. If N 4 0, then the contents 
of A register bits and 1 are examined. If the bits are different, the 
scale is stopped. Otherwise, the scale operation then takes place as a 
left shift of A or AQ and continues until either the bits at the scale 
point are different or until the contents of N are reduced to 0. At 
completion, the difference of the initial value of N and the final value 
of N is the number of bits that A or AQ was shifted. The A, B and D 
fields of the coding form should be left blank so the assembler can 
insert the correct values. 

The examples depicted in Figure 4-6 assume that a number is positioned 
in the A/Q registers and must be scaled. In the one's complement example, 
an end-around scale is used to provide for the propagation of the correct 
value for the least significant bits. In the two's complement example, 
a zero entry scale is used. 
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Scale operations are as follows: 



F Code Operation 

SLOE Scale A register left with entry. 

tf\ SL1E Scale A register left with 1 entry. 

SLEA Scale A register left, end-around. 

SDLOE Scale AQ registers left with entry. 

© SDLEA Scale AQ registers left, end-around. 



© A, B, AND D FIELDS 
© 



The A, B and D fields of the microinstruction specify sources and des- 
tinations of information in the MP organization. In all three fields, 
there are basic mnemonics and extended mnemonics. In the object language 
output, the A, B and D fields occupy three bits each and thus allow only 
for specifying one of eight different sources and destinations. Since 
more than eight sources and destinations may be specified in each field, 
the S field is used also to provide alternate coding interpretation for 
the 3-bit number in the A, B and D fields. Alternate codes are referred 
to as A', B 1 , D', D" and DD". The MP assembler accepts any of the 
specified alternate mnemonics for the fields and provides an automatic S 
field setting in the object code output. The result of the use of the S 
field to specify operations, as well as alternate decodings of the A, B 
and D fields, leads to a possible conflict of mnemonics. The resolution 
of this conflict is described in Appendix D of this manual. The assembler 
#% also provides diagnostic messages if any conflict occurs in the source 



program. 



A FIELD 



The A field specifies a source of information to the output of selector 
1 and is available for the A input of the ALU. 



o 
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A Code Operation 



P 



A 



F Use contents of F register as A source. 

Fl Initial value of K at start of microinstruction specifies 

address in File 1.* 



A Code Operation 
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F2 Initial value of N at start of microinstruction specifies 
address in File 2.* 

Use contents of P register as A source. J 1 

I Use contents of I register as A source. 
X Use contents of X register as A source. 

Use contents of A register as A source. i| 



'\_jp 



c 

MEM Contents of main memory are transferred. Data 

must have been read in a previous microinstruction. (\ j 

The following A codes (A 1 codes) are extended mnemonics; the S field must \ ; 

be left blank. 



V_y 



SMI Use contents of SM register 1 as A source. 

SM2 Use contents of SM register 2 as A source. \.y 

Ml Use contents of interrupt mask register 1 as A source. /t~n 

M2 Use contents of interrupt mask register 2 as A source. 



G 



*RESTRICTION: Value of addressing register (N or K) cannot have been 

modified by a C field increment or decrement command in the preceding f'\ 

. . . \ > 

microinstruction. In addition, whichever file is used during current 

microinstruction, this file cannot have been written in the preceding 

microinstruction. 
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B FIELD 
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The B field 
2 and is av* 

B Code 
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ZERO 
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BG 


© 
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K 
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The B field specifies a source of information to the output of selector 
2 and is available for the B input of the ALU. 

Operation 

Use all zeros as output of selector.* 

Use N register as bits 16 through 23 of seleptor 2 with 
zeros as rest of selector 2.* 

Use single bit set to 1 with rest O's. The bit to set is 
controlled by either value of lower five bits of C field of 
this microinstruction or contents of N register as elected by 
setting of status/mode bits. 

Use K register as lower 8 bits of selector 2 with zeros as 
rest of selector 2.* 

Use N and K registers as lower 16 bits of selector 2 with 
zeros as rest of selector 2. K fill's bits 24-31 and N 
fills bits 16-23.* 

X Use contents of X register as B source. 

Q Use contents of Q register as B source. 

■J! F Use contents of F register as B source. 

Fl Use contents of a word in File 1 as B source input. Value 

of K at start of microinstruction specifies address in File 1.** 



O 

O 

© 

A 



F2 Use contents of a word in File 2 as B source input. Value 

of N at start of microinstruction specifies address in File 2.** 



© 

© 

*Selection of this B code option is controlled by setting bits 28 and 29 

ffp of the microinstruction in the C field. Other C field commands may be 
given if they match in bits 28 and 29. The assembler allows this 
operation. 



**RESTRICTION: In the preceding microinstruction, the addressing register 
(N or K) cannot have been incremented or decremented and whichever file is 
read (Fl or F2), cannot have been written. 

17328900-02 4-15 



B Code - Operation 

MEM Contents of main memory is used as B source. Data must have 
been read in a previous microinstruction. Restriction: If 
extended A code is used, data from A source is also used as 
B source, suppressing memory data. 

The following B codes (B 1 codes) are extended mnemonics and the S field must 
be left blank. If these extended mnemonics are used, it is not possible to 
use extended mnemonics in the A or D field. 

B Code Operation 

CRTJ Read the complement of the RTJ register in the lower 12 
bits of selector 2. 

INRD Read data/status through I/O TTY card from peripheral 
devices. 

INRS Read responses from I/O TTY card. 

MMU Transfer data from micromemory to X register as a 

destination. Data is passed through ALU, and F field 
must make reference to B source. D field, if specified, 
will also contain the data from micromemory.* Next 
microinstruction is always next sequential upper 
instruction. 

INTA Read complement of address of current highest priority 

active interrupt having its corresponding mask bit set to 
output of selector 2. Address consists of bit number of 
mask bit that controls interrupt. An INTU test command 
must have been given in the preceding microinstruction. 



o 
o 
o 

o 






o 

vy 



w 



V„,-' 



*The address of micromemory is determined by the transform number specified 
in the C field or NK, and the upper or lower location is specified by the 
test field of this instruction. 



C 



'i. - 



4-16 



17328900-02 



o 



o 

© D FIELD 



© 

© 

© 

© 



© 

o 

© 

© 

© 

© 

© 

© 

© 

© 

© 
fl 



The D field specifies the destination of information from the main 
organization of the MP. There are four sources of information for de- 
livery to the specified destination. These are: 



* The optionally shifted output of the ALU. Thip shifting occurs 
in a shifting network (selector 3) that provides the shift 
on the output of the ALU. 

* The direct (unshiftable) output of the ALU. 

" The output of selector 1 (input to the selector is specified 
#\ by the A field). 

* The output of selector 2 (input to the selector is specified 
by the B field). 



D Code Operation 

NOP Do not transfer any information to any destination. 

P Transfer output of ALU as shifted by selector 3 to P register. 

I Transfer output of selector 1 to I register. 

Q Transfer output of ALU as shifted by selector 3 to Q register. 

Fl Transfer output of ALU as shifted by selector 3 to F register, 
and then write in file 1 during first part of next micro- 
instruction. 

Location in file 1 to receive information is specified by 
contents of K register on completion of this microinstruction. 
Note that if next instruction specifies Fl in A or B field, 
an erroneous result will be received; the information is 
available in the F register and should be obtained 
from there . 

17328900-02 4-17 
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D Code Operation f\ 

A Transfer output of ALU as shifted by selector 3 to A register. f\ 

X Transfer output of ALU as shifted by selector 3 to X register. 

F Transfer output of ALU as shifted by selector 3 to F register. (f\ 

The following extended D (D ! codes) may be specified in the same microinstruc- (f ~Yj 
tion as an extended A code. The assembler provides the proper S field setting. 

o 

D Code Operation 

o 

MMU Transfer output of selector 2 to 32-bit micromemory word. 

Micromemory address is specified by transform corresponding to 

number contained in C field of this microinstruction. Upper 

or lower micromemory word is specified by T field of this ^ ^ 

microinstruction. Next microinstruction is taken from next 

sequential upper location. 



*Outputs to the mask and status/mode registers are not shiftable. 
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Ml Transfer output of ALU to Ml register.* 

M2 Transfer output of ALU to M2 register.* 

SMI Transfer output of ALU to SMI register* 

SM2 Transfer output of ALU to SM2 register.* 

IOD Transfer output of selector 3 (S3) to I/O data register on v 

TTY card. ,/*' 

IOA Transfer output of selector 3 (S3) via the I/O data register 

to 1/0 address register. Destroys contents of I/O data (? 

register. 



/T^, 
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EXAMPLES OF F, A, B, AND D FIELDS 

The assembler output listing shown in Figure 4-7 demonstrates the basic 
use of the fields discussed above. In some cases, the S and C fields 
will also be used to demonstrate common programming errors that are 
detected by the assembler. 

S FIELD 

The special field (S field) is coded in columns 35 through 40 of the 
assembly coding form. If this field is not used by the assembler to 
specify alternate translations for the A, B or D fields, it may be used 
by the programmer to specify a special instruction or it may contain a 
constant or a programmer defined symbol. The S field mnemonics specifying 
alternate A, B or D field codings are not normally used by the programmer 
and are automatically generated as required by the assembler. 

These S codes specify operations taking place in parallel with the F and 
C codes. 



© 
© 
© 
© 



S Code Operation 

NOP No operation specified in S field. 

RPT If contents of N register are not equal to zero, decrement 
N by one and take current microinstruction pair, using 
upper /lower decision implied by T field. If contents of N 
register equals zero, decrement N by one and use microin- 
struction sequencing specified by M field and T field, 

L8EA Selector 3 is set to provide shift of data left eight bits, 
end around. This provides shift of ALU output to P, A, 
F, X and Q registers if used as destinations. 
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S Code 


o 


F2WR 


o 




o 


GATE I 


© 


HALT 


o 


RTJ 





CLRNP 


o 




o 


RD1 
RD2 




RD3 



Operation 

Write contents of the F register into file 2 at address 
specified by contents of N register at start of this 
microinstruction. Must not be specified if preceding 
microinstruction used F2 as a destination code. 

Transfer output of selector 1 to I register. 

If SM109 (halt bit) is set to 1, complete this microinstruc- 
tion and halt operation. 

Transfer address of next sequential microinstruction pair to 
RTJ register. 

Clear N register and set page register in P-MA register so 
next microinstruction will be executed from page 0. This is 
normally used with J or R in M field of microinstruction. 

Gate data specified by lookahead register 1, 2 or 3 onto the 
main bus for use by the next instruction at selector 2, MEM 
in the A or B field would allow the data to be stored in a 
register specified in the D field. 
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The following S codes are not normally used by the microprogrammer 
because they are set by the assembler to handle extended A, B and D 
field mnemonics. 

AP (for A' codes) 

BP (for B' codes) 

DP (for D' codes) 

APDP (for A 1 and D' code combination) 

DPP (for D" codes) 

EXAMPLES 

The code shown in Figure 4-8 will count the number of 1 bits in the A 
register. Assuming two's complement arithmetic, the total number of 
1-bits will be left in the Q register. 
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C FIELD 

The C field is a multipurpose field and its interpretation is dependent 
on the M field. 

JUMP INSTRUCTIONS 



o 
o 



The code at HERE adds X to itself to get a left shift of 1, and the COL 

in the T field checks for carry out of the high order bit if it is a 1. f\ 

If there is no carry out, the upper instruction at HERE is repeated. If 

there is a carry out, the lower instruction is performed, which adds one €\ 

to the A register and jumps back to HERE. Each execution of the instruction 

at HERE counts N down by one. When N is counted down to zero, control tf\ 

goes to the next sequential upper instruction, since a two's complement 

adder is assumed, leaving all zeros in the X register after the 32 

additions of X to itself. 



o 









A~A 



If the M field is coded with a J, the C field is taken as a jump address. 

It may contain a constant, which expresses page and location within the 

page. In this case, the T field must be coded to specify the upper or 

lower location to be jumped to. The C field may contain a symbol, which W 

identifies a page or location within the page and an upper or lower 

property. In this case, the T field may be left blank and the assembler 

will select the correct upper or lower designation. If a T field value 

is given, it will override the assembler selection. \^ 

The page to be jumped to is examined by the assembler, along with the (f 

page of the jump instruction. If the jump is within the same page, 

format 2 with bit 19 clear (refer to Figure 4-2) is selected , allowing (fj 

use of the S field for special instructions. Otherwise, format 2 with 

bit 19 set is selected. ■ T) 

c 
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FLAG SETTING AND CLEARING COMMANDS 

The Status/Mode registers contain bits which are individually associated 
with various status and operation modes. The individual bits in the 
Status/Mode register which can be turned on/off are called flag bits. 



o 
o 

o 



Flag Number 


SM Reg. No. 


Bit No. 


Function 







00 


Double Precision 


1 




01 


One ' s Compl iment 


2 




02 


Bit Generation from N Register 


3 




03 


Adder Split 


4 




16 


Lock Memory 


5 




17 


MP60 Bit Register 


6 




18 


Monitor (Program) Mode 


7 




19 


Reserved 


8 


2 


00 


Enable Auto Data Transfer 


9 


2 


01 


Read I/O Strobe 


10 


2 


02 


Write I/O Strobe 


11 


2 


03 


Sterm I/O Strobe 


12 


2 


16 


Test/XMC MPM (MPM Test Mode) 


13 


2 


17 


Isolate BSC (BSC Test Mode) 


14 


2 


18 


Reserved 


15 


2 


19 


Page Address From S3 



The commands are written as follows: 



SETF/m 



CLRF/m 



where m is a constant or a symbol, m is converted to binary and the 
least significant four bits are used to specify the flag to be set 
(set to 1) or cleared (set to 0). 



o 

G 

o 
c 



c 



\y 
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® REGISTER SETTING INSTRUCTIONS 

\J The register setting instructions set the K and the N register and are 



o 



o 
o 

o 
o 



coded as follows: 

* K=value 

* N=value 



#\ where value may be a constant or a symbol. The constant or symbol is 
expressed in binary, and the lower eight bits of the binary value are 
inserted in the C field of the microinstruction as the value to be set 
into the specified register. 



If the S field contains the CLRNP command, the result of a K= or N= in 
the C field will be zero in the specified register, along with a zero in 
the N register. 

REGISTER CONTROL COMMANDS 

The register control commands provide for incrementing, decrementing, 
and clearing the K or the N register. The commands are as follows: 

C Code Operation 

Increment K register by 1. 
Increment N register by 1. 
Decrement K register by 1. 
Decrement N register by 1. 
Clear K register. 
Clear N register. 

If the T field specifies a test of the register, the test is made on the 
initial value of the register before the control command. 



o 


INCK 





INCN 


o 


DECK 
DECN 


o 


CLRK 


o 


CLRN 
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SELECTOR 3 (SHIFT COMMANDS) 

The following C field commands specify a left or right shift one bit 
position of data transferred from the ALU through selector 3 destined to 
P, A, F or the X register. The contents of the Q register may be com- 
bined with the destination register to make a double length register, 
with Q register as lower order bits. These shifts are end off with 
provision for entry of 0, 1 or the inverse of the sign of the ALU output. 
The Q register may not be used as a destination register in any of the 
following commands and obtain correct results. Also, these commands cannot 
be performed when S field contains L8EA. 



o 
o 
o 

o 









First Part Direction 



R (ghift destination register) L (left) 



RQ (shift destination and Q) R (right) 



Entry To Open Bit > 

0E Enter zero 

IE Enter one 

XN Enter complement 
of ALU sign 



o 



The allowable mnemonics for the shift operations are as follows: 

C Code Operation 

RQLXN Shift destination and Q left with complement of ALU sign 
entered into lowest bit position of Q. This command is 
used in divide iteration. 

RQR1E Shift destination and Q right and enter 1 in sign position 
of destination register. 

RQROE Shift destination and Q right and enter in sign position 
of destination register. 



O 






CU 



O 
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C Code Operation 

RLOE Shift destination left and enter in lowest bit position. 

RL1E Shift destination left and enter 1 in lowest bit position, 

RROE Shift destination right and enter in sign bit position. 

RRlE Shift destination right and enter 1 in sign bit position. 

TRANSFORMS 



o 
o 

© 

© 

© 
© 
© 

Transforms are used to provide a means of forming micromemory addresses 
Mj) or constants from any pattern of bits from selectors, registers or data 

paths of the processor. The addresses may be used to sequence micro- 
■"■ memory or to set the N or K registers. 

The transform instructions in the C field are written as follows: 

TMA/j TK/j TN/j TR/j TMAK/j GITMAK/j 

■J where j is a symbol or a transform number. The symbol or number is 

expressed in binary, and the lower four bits of the number are inserted 

^J in the microinstruction. The S field may contain a symbol or a constant 
to specify the page used in the MA transform. For the TN/ and TK/ 

^J instructions, the S field must contain a symbol or a constant to avoid 
an informative diagnostic from MASS. 

o 

C Code Operation 

o 

TMA/j The micromemory transform begins execution at one of the 
fl|l 256 microinstructions (of the current micromemory page) 

specified by either S2 or the IXT register. The transform 
(Q) number j specifies the register and the bit field as follows: 

o 
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TRANSFORM NUMBER j OPERATION 



whether the N or the K register is specified. The follow- 
ing chart summarizes the bits that are loaded into the K 
and K' , or the N and K' register. 



Bit 11 of Status Mode register 1 is -0 if File 3 is to be 
addressed and =1 if File 1 is to be addressed. 



o 

o 

o 



o 



Not Defined 

1 Micro Addr = Bits 0-5 of S2 

2 Micro Addr = Bits 1, 4-10 of IXT 

3 Not Defined 

4 Not Defined 

5 Not Defined 

6 Not Defined 

7 Micro Addr = Bits 24-31 of S2 (f\ 

TK/j Load the K or N register and the K' register with data 

TN/j from S2 5 the GPU state register/IXT register, the MIR or %j) 

the F 1 register. The following table describes the 

various fields that are loaded into the K or N register '\}i 

from bits 0-7 of S8. Bits MSB-7 of S8 are used to load 
the K' register and the K' register is always loaded \^J 



*- 



'^_y 



The symbols under the transform number denote whether the 
transform is wirewrapped (A), clad (O) or unassigned yy 

(OPEN). The number under each of the bit numbers of S8 

denotes the register and the bit number which the N or K ^ 

is loaded. Example: Bit 7 of transform shows S231. 
This means bit 31 of S2 is loaded into the least signi- 
ficant bit of K, K' or N, K 1 register. 



o 



Generally, transforms 2, 3, 4, 5 and 7 are used to assist ^j 

in decoding MP-^60 type assembly instruction (see MP-60 

Reference Manual, Publication No. 14306500A, pages 6-1, 6-4). %J) 
Transform 2 is used to decode the B field; Transform 3, 
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TR/j 



TMAK/j 



GITMAK/j 



the sub-opcode field; Transform 4, the index field 
for half-word addressing; Transform 5, the index field 
for character addressing; and Transform 7, the C field 
decode. 

The register transform is used to route data directly 
into File 3 from either S3 or from another register. 
Presently, only transform is available, which puts bits 
0*31 of S3 into File 3. 

Transfer data to the K register as specified by the 
wiring of the K/N transform j and then perform a TMA/j. 

Gate the output of selector 1 to the IXT register and 
then perform a TMAK/j transform. 



OTHERS C CODES 



C Code 



LWAri 



Operation 



Load word address into lookahead register n from page file 
and S3. If write memory mode is selected, the data in 
the register in Si (A field) is used. 



o 
o 
o 



o 
o 



(A 



o 



%_> 



LHAn 



Load half-word address into lookahead register n. 



LCAn Load character address into lookahead register n. 

LBAn Load bit address into lookahead register n. 

WPF Load the page file (specified by address in S3) 
with the data word from SI. 

RPF Gate the contents of the page file (specified by address 
in S3) to the main CPU bus for use in SI or S2 during 
the following instruction cycle. 

WSR Load the state register specified by S3 with data from SI, 
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C 






O 



o 

o 
o 

EXAMPLE OF C FIELD CODING 



o 
o 

© 

o 



: 



o 



o 

II 



RSR Gate the contents of the state register (specified by 
address in S3) onto the main CPU bus for use in SI or 
S2 during the following instruction cycle. 



If the M field is coded with a J, the C field is used as the address pf 
the micromemory jump destination. The examples in Figure 4-9 show legal 
and illegal use of the S field in conjunction with the C field. 

Examples of multiply and divide codes implemented in an MP which uses 
one's complement arithmetic are shown in Figures 4-10 and 4-11. 

M FIELD 

The M field is coded in column 50 of the assembler coding form. The 
mnemonics in the M field specify the method of selecting the next 
microinstruction pair (upper and lower) to be executed on completion of 
the current microinstruction. 

If the M field is left blank, MASS assumes that a sequential (S) 
specification is required. 

The code selected in the M field may be overridden in two cases: 

• If the T field has the code *L, the lower microinstruction 
of the current microinstruction pair is selected regardless 
of the M field code. 

* If the C field specifies the transforms TMA/ , TMAK/ or 
GITMAK/, then the transform addressing takes precedence 
over the M field code. 
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Operation 

Sequential addressing. If T field is left blank, MASS 
will select the next sequential microinstruction either from 
from current pair or from next microinstruction pair. If 
the T field is not blank and dpes not contain a *L (select 
current lower instruction), the upper instruction of the 
next sequential microinstruction pair within current page 
of micromemory will be selected. (Note that location 00]^ 
in current page follows location FF.) 

Jump addressing, Next microinstruction pair will be 
selected from micromemory location specified by symbol 
or constant coded in C field of current microinstruction. 
MASS will select the correct type of jump based on current 
program address and jump destination. If the jump 
address is in the current page, a within-page jump will 
be performed and the S field is available for coding. 
If the jump address is in another page, the assembler 
will use the S field to specify the page in a page-jump 
^% instruction. If T field is left blank, MASS will select 

correct upper or lower T value for the symbol. 

© 

R Return addressing. Next microinstruction pair is selected 

m% from location in current page specified by contents of RTJ 

register. The four MSB bits specify the page and and the 

4% remaining eight bits specify the address within the page. 

The RTJ register must have been previously set up by an 

#1 RTJ in the S field. If the current S field contains 

CLRNP, the next microinstruction pair is selected from 

4fe page as specified by contents of RTJ register. 



o 



T field must be filled in with an upper/lower selection. 



17328900-02 4 ~ 35 



i% 



o 

T FIELD Q 

The mnemonics in the T field specify the selection of the upper or the £\ 

lower microinstruction from the next microinstruction pair for execution 
on completion of the current microinstruction, except *L. The final jf\ 

letter of the mnemonic specifies the upper (U) or the lower (L) microin- 
struction to be selected if the condition specified by the first letters (f\ 
of the mnemonic is true. 



When micromemory is being read or written as an operand, the T field is 

used to address the referenced micromemory location and the upper instruction tf\ 
in the next sequential microinstruction pair is always selected. 



The following T field mnemonics may be included in any microinstruction: 



This operation overrides M field addressing mode. 

U Select upper of next pair. 

L Select lower of next pair. 

I KZU If initial contents of the K register is zero, select 

upper of next pair. Cannot be used with C field INCK. 



ZL If output of the ALU is zero on completion of current 
microinstruction, select lower of next pair. 

The following T field mnemonics are usable only in format 1 as shown in 
Figure 4-2. The use of these mnemonics with other formats, such as a jump 
or N= or K= in the C field, will cause an assembler diagnostic. 
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T Code Operation 'AJj 

*L Select the lower of current microinstruction pair. ^x 



r^. 



v 



T Code Operation /fx. 

I NZU If initial contents of the N register is zero, select 

upper of next pair. Cannot be used with C field INCN. (f^ 

NU If output of ALU is negative on completion of current 
microinstruction, select upper of next pair. 









o 
o 

o 
o 

o 
© 

o 



T Code Operation 

LQL If at start of this microinstruction the least significant 
bit of Q is 1, take the lower of next microinstruction pair, 

1NTU If there is an interrupt, and the corresponding mask bit 
in the mask register is set, execute the upper of the 
next microinstruction pair. 

BTU If the bit selected by the least significant four bits of 
the C field is set, execute the upper of the next micro- 
instruction pair. Presently, only the following bits are 
selectable: 



C Field Value 
2 
5 
9 

F 



Test 

Bit Register 

Selective skip bit of FCR 
Monitor/Program Mode Bit 
Macro RUN/ STOP Bit 




© 

© 

o 
o 



COL 



■K7.L 



OVFL 



ERL 



If there is a carryout of ALU from arithmetic operation, 
take lower of next pair. 

If the least significant bit of K register is set, 
execute lower of next microinstruction pair; if clear, 
execute upper of next microinstruction pair. 

If overflow exists, execute the lower of the next microin- 
struction pair; if not, execute upper of the next micro- 
instruction pair. 

If any memory fault occurred, take the lower of the next 
microinstruction pair. 
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ASSEMBLER PROCESSING OF M AND T FIELDS 
SEQUENTIAL ADDRESSING 



a 



value in the T field. 



o 
o 



If the M and T fields are left blank, the assembler will assume sequen- 
tial addressing mode and will choose a T code in the object code output #>i 
to execute the next sequential microinstruction. If the current 

microinstruction is an upper, the *L code will be inserted for the T '/#> 

field. If the current microinstruction is a lower, a U code will be 
inserted in the T field. O) 

The example in Figure 4-12 shows assembly output of two sequences of f^ 

code to show two ways of specifying sequential addressing. 

/On 

In Figure 4-13, the instructions with NOP coded in the D field are not 

executed, but the other instructions with coding are executed. This ^"^ 

example shows how it is possible to interleave two paths of program 

'■'-'' i- • i • -"" x 

flow through one set of micromemory locations. 

JUMP ADDRESSING 



V-jf' 



If a J is coded in the M field, the C field is interpreted as the jump 

destination address. The C field may contain a symbol or a constant. 

A symbol is carried as an actual micromemory location address and has an ^ 

upper or lower property as well. A constant is interpreted as an upper 

micromemory address. If no T field value is specified, the assembler 

provides the correct T field value for the location addressed. However, 

the default T field selection is overriddened if the programmer specifies (f^ 






o 



The assembler compares the page of the jump destination address with the 

page of the current microinstruction. If the page numbers are the same, ,0; 

a within-page jump is coded and the S field may be used for additional 

instructions. If the pages are different, a page jump is coded and the Q 

page number is extracted from the constant or symbol value and inserted 
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in the S field for the object code. The location within a page is coded 
in the C field of the object code. If the programmer has used a value 
in the S field and a page jump is coded, a diagnostic will be generated. 

The example in Figure 4-14 shows four methods of arriving at a specific 
microinstruction. 



o 
o 
o 



o 



o 

c 

Q 



RETURN ADDRESSING 

Return addressing causes control to be returned to the microinstruction 

pair specified by the contents of the RTJ register. The programmer 

must specify a value in the T field to get a correct return location 

(upper or lower of the microinstruction pair). The RTJ register may be 

set any time by placing the mnemonic RTJ in the S field of a microinstruc-' 

tion. The address stored into the RTJ register is that of the next se- 

quential micromemory word following the instruction with RTJ in the S ^^ 

field. Both page and address within a page are stored in the RTJ register. 

The example in Figure 4-15 shows use of return addressing. In this 
example, a jump is made to the routine SUB which tests the value in the 
A register. Return is to the lower of the following microinstruction 

pair if the value in the A register is negative, and returns to the upper ^ 

' ■ ... V> 

of the pair if the value is positive. 

.: : c 



*_> 



c 
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MAIN MEMORY INTERFACE 



#\ The Memory Interface performs the following basic functions: 

#■% * Converts a programmer address to a physical address. 

Decouples microprocessor and memory timing, using look-ahead, 
O 

O 
© 

O 
O 



O 



Formats address and data for full-word, half-word and 
character operations. 

MEMORY ACCESSING 

Supporting up to 4 million words of main memory and providing capabilities 
for virtual memory, memory protection and dynamic allocation is achieved 
by logically dividing memory into blocks, or pages. Each page consists 
of 2048 contiguous words. To access a maximum memory of 4 million words 
requires 2048 pages and an address of 22 bits. The required 22-bit 
address is divided into an upper and lower portion of eleven bits each. 
The upper portion selects one of the 2048 possible pages , while the 
lower portion selects one of the 2048 words within the selected page. 
The lower portion comes from 11 word address bits of the macroinstruction. 
The upper portion is supplied from an entry in the page index file. 

Figure 5-1 shows the creation of the actual physical address from the 
macroinstruction operand fields and the page index file. 

PAGE INDEX FILE 

The Bage Index File is a 1024, 17-bit bipolar random access memory. The Page 
Index File is micro-accessible (see WPF, RPF instructions) and is logically 
divided into 32 groups of 32 entries each. The CPU Program State Register, 
when in State Mode (or 5 bits from the macroinstruction, when in Direct Mode), 
selects one of the 32 groups. Five bits from the upper part of the word 
address in the macroinstruction selects one of the 32 entries in the group. 
This was done to help assist in the emulation of the MP-60 instruction set. 
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Each of the 32 groups represents an individual state. Each of the entries in 
that group represents a logical page of 2048 words, so a state has a logical 
maximum size of 65K words. 

Along with providing page addresses, the Page Index File supplies odd parity 
information to the memory protect logic. 

MEMORY PAGE ADDRESSING 

As shown in Figure 5-2., each Page Index File entry contains an 11-bit address 
for a particular page of main memory. Together with 11 bits from the word 
address in the macroinstruction, this provides addressing for over 4 million 
words of main memory. Although the Page Index File can hold only 1024 of the 
2048 possible page addresses at any one time, the file can be changed by 
microprogram instructions to allow access of the maximum memory present. 
Actual memory address generation is discussed under MEMORY ACCESSING. 

The page address parity logic generates au odd parity bit on the 11-bit page 

address as it is loaded from selector 1. This bit is stored at bit position 

15 when the page address is stored in the page index file. When this page 

file entry is accessed, the parity bit is sent with the page address to 
the holding register. 

PAGE STATUS 

Bit positions 17 and 20 hold the MODIFIED and ACCESSED status bits 
respectively. The page status logic monitors activity of the Page Index 
File. When a Page Index File entry is accessed for a read operation, the 
page status logic sets the ACCESSED bit in that entry. On a write opera- 
tion, both the ACCESSED and MODIFIED bits are set in the corresponding Page 
Index File entry. 

MEMORY PROTECT LOGIC 

Bits 16, 18 and 19 specify the protect state associated with each page. 
These bits are monitored by the protect logic to ensure that no illegal 
memory operations are allowed to occur. These bits are used as follows: 

17328900-02 5-3 



BIT NUMBER (SI) 

15 

16 
17 
18 
19 
20 
21 



LSB 



31 



PAR 



NRP 



MOD 



ROP 



FPP 



ACC 



BIT FUNCTION 

PAGE ADDRESS PARITY (ODD) 

NON-RESIDENT PAGE 

PAGE MODIFIED BY WRITE 

READ ONLY PAGE 

FULL PROTECT PAGE 

PAGE ACCESSED BY READ OR WRITE 

\ 



S MAIN MEMORY PAGE ADDRESS 



31 ' 



Figure 5-2. Page Index File Entry Bit Assignments 



o 

o 
o 
o. 

o 



o 






v.y 












C 
C 



O 



5-4 



17328900-02 



o 

© 

* Non-Resident Page - Bit 16 indicates that the page is physically 
m\ or logically not present in the system and cannot be accessed. 

* Read Only Page - Bit 18 indicates that the page may only be 
accessed by read instructions. 





© 
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* Full Protect Page - Bit 19 indicates that the page is not avail- 
able for any access. 

PROGRAM STATE REGISTERS 

The memory interface contains one (1) CPU State Register and four (4) DMA 
State Registers, one for each DMA port. These state registers perform 
the following functions: 



#%) * Provide the upper half of the Page Index File address for 

main memory addressing. 

\Ji * Provide mode control. 

* Report fault conditions. 

CPU STATE REGISTER 

£\ The CPU State Register is accessible by using the WSR, RSR mnemonics 

in the C field. The CPU State Register bit assignments are shown in 
f% Figure 5-3 and are used as follows: 

* Mode Control - Bits 20-22 are mode control bits for the three 
lookahead address/data register pairs of the CPU. Setting 
a bit puts the corresponding lookahead register pair in the 
write mode. Clearing a bit puts the corresponding lookahead 
register pair in the read mode. 



* Addressing - Bits 27-31 form the upper portion of the Page 

Index File address, selecting one of 32 groups of 32 Page 
Index File entries. Refer to MEMORY ACCESSING section for a 

discussion of address generation. Bits 27-31 are also routed 
to the backpanel for use by the transform module. These bits 
are undefined after a master clear. 

17328900-02 5-5 



Fault Reporting - Bits 15-26 are used to report faults that 
have occurred during CPU memory operations. The bits are set 
by the fault detection hardware and may be cleared by using 
a read-modify-restore microcoded sequence. 

Bits 13-14 - These bits are constantly updated and have no 
significance until a DMA error occurs (bit 23 is set). When this 
happens, they contain the number of the DMA port which caused the 
error. Bit 23, when set, prevents any changes to bits 13-14 until a 
WSR (Write State Register) function is issued to the CPU State 
Register. These bits are undefined after a Master Clear. 

Bit 15 - This bit will be set when a timeout error occurs, along 
with one of the lookahead error bits (bits 23-26) indicating which 
one generated the timeout error. This bit is cleared with a WSR 
instruction or a Master Clear. 

Bits 16-19 - These bits, all of which could be set; simultaneously, 
indicate a parity error on the corresponding data character(s) . One 
of the lookahead bits (bits 23-26) would be set at the same time, 
indicating which lookahead register set caused the error and, at the 
same time, blocking any further setting of data parity error flags 
by subsequent errors. A Master Clear or a WSR instruction will 
clear these bits and remove the inhibit update signal. 

Bits 23-26 - These error flags are set on any error to indicate 
which lookahead register set generated the error. In addition, 
these bits prevent any further update of any other error information 
until the CPU clears these bits with a WSR instruction or a Master 
Clear. Any bit set will inhibit the updating of state register bits 
16-19 (Data Parity bits). Bit 23 will inhibit the updating of state 
register bits 13-14 (DMA port number in error). Presently, only 
lookahead 1 is testable using T field logic. ERL in the T field 
would force execution to start in the lower of the next 
microinstruction pair on a fault. 
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BIT NUMBER BIT ASSIGNMENT 



13-14 DMA PORT NUMBER IN ERROR 



15 TIMEOUT ERROR 



16 
17 
18 
19 

20 
21 
22 



23 DMA (LOOKAHEAD 0) ERROR FLAG 

24 LOOKAHEAD 1 ERROR FLAG 

25 LOOKAHEAD 2 ERROR FLAG 

26 LOOKAHEAD 3 ERROR FLAG 

27-31 UPPER 5-BIT PAGE INDEX FILE ADDRESS PORTION 



CHAR 




DATA PARITY ERROR 


CHAR 1 




DATA PARITY ERROR 


CHAR 2 




DATA PARITY ERROR 


CHAR 3 




DATA PARITY ERROR 


LOOKAHEAD 


1 


READ/WRITE BIT 


LOOKAHEAD 


2 


READ/WRITE BIT 


LOOKAHEAD 


3 


READ/WRITE BIT 



DMA STATE REGISTERS 



%J5 The DMA State Registers are used to perform two functions for the CPU: they 
provide Page Index File information for main memory addressing and transfer 
mode control (half word/full word) information to the DMA port logic. The 
selection of the DMA State Register to be read or written is determined by the 

%J least significant two bits from S3. All mode bits and set of address bits are 

written to a Data State Register with a WSR instruction. All mode bits and 
one set of address bits are read back with each RSR instruction. Bit 
assignments are shown below. 
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BIT NUMBER 



BIT ASSIGNMENT f\ 

23 TRANSFER MODE BIT ~ PORT 

24 TRANSFER MODE BIT -- PORT 1 

25 TRANSFER MODE BIT — PORT 2 



26 TRANSFER MODE BIT — PORT 3 

27-31 UPPER 5-BIT PAGE INDEX FILE REGISTER PORTION 

• Bits 23-26 - These are transfer mode bits selecting either half word 
(0) or full word (1) operation for the corresponding DMA port. 

• Bits 27-31 - Upper 5-bit Page Index File address portion. 

CODING EXAMPLES FOR MEMORY INTERFACE 
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Figure 5-4 shows coding for reading and writing the contents of a Page Index 

File entry, Reading and writing the program and DMA state registers are shown '\J 

in Figure 5-5. Reading physical location 00 using state 2 and Page Index File 

entry 34 are shown in Figures 5-6 and 5-7. Placing the address of a main 

memory word within the word for the first 65,536 locations is shown in Figure 

5-8. Figure 5-9 is an example of using a TK transform and lookaheads to ^y 

perform a main memory cycle. Figure 5-10 shows a TMA transform and the 

processing of interrupts. V^ 
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MPSIM MICROCODE SIMULATOR 



MPSIM is an interactive simulator which simulates the microcode execution of 
the CDC Microprogrammable Processor (MP) and the Basic System Controller, 
Model 65109. It is designed to run interactively using a remote terminal, or 
in batch mode, on a CDC CYBER 170/70/6000 computer running the NOS/BE or 
KRONOS operating system. 

MPSIM provides a tool to the microprogrammer which allows him to check his 
coding without actually running it on the MP. Features are provided which 
make debugging much easier using MPSIM rather than the MP. Some of these 
features are: 

* Communication with MPSIM using symbols from the MASS assembly 
listing is possible. 

* Tracing of instruction execution ranging from full trace, to memory 
writes, to no tracing may be selected. 

* Multiple breakpoints may be set. 
Extensive trapping facilities are available. 

A history of all interactive operations may be captured and printed. 

Execution may be suspended and the current state of the simulation 
saved on a file. 
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MPSIM OPERATION 

u 

While MPSIM may be run as a batch job, it is strongly recommended that 

the user become familiar with MPSIM by interactive operation before {Q 

batch use is attempted. In interactive mode, a question mark (?) is 

displayed on the terminal any time MPSIM is ready for user input and ^jJ 

displays are always sent to the terminal unless DUPONLY is used. In 

batch mode, "display" is equivalent to "print". 



o 






First, a microprogram must be available for simulation. The micropro- 
gram is assembled on the CYBER, using the MASS assembler. The MASS 
option SIMULATE must be specified on the OPTN pseudo instruction to 

produce a binary simulation file (SIMFIL) . Once this file has been \J 

created, the user logs in on an interactive terminal, attaches or ^^ 

generates SIMFIL and executes MPSIM. The first command to MPSIM is ^ '" 

typically LOAD. LOAD reads SIMFIL into MPSIM which initializes micro- s~\ 

memory and MPSIMs symbol table. Breakpoints may be set to return control 
to the user when a particular location in the microcode is reached. ^ 

Traps may be set to cause various displays when specified microcode 

locations are executed. Normally, a trace of all instructions executed : ^J 

is given, along with accumulated simulated time. Further commands as ^ 

described below may be given to control the running of the simulation. 
See the EXAMPLE RUN given later in this document. /f"\ 

Using the TLIM command, the user can establish a time limit for micro- \^j 

code "execution" after which control is returned to the user. Otherwise, 

the time limit is disabled. The execution time is the accumulated micro- \J 

instruction execution time since the first RUN command or since a later 

RUN that specified an address. 
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INTERACTIVE COMMANDS 

The following notation is used in command descriptions: 

Brackets [] indicate optional elements which may be omitted 
or included as desired. 



■ "j Braces O indicate possible elements, one of which must be 

chosen and the other omitted. 



Ellipsis .... indicate a variable number of similar elements 
may be used. 

Words in UPPER CASE indicate specific terms. 

Words in lower case represent information the user is to supply. 

Values and addresses are always in hexadecimal, unless noted. 

The term mmadr represents a micromemory address of the form 
paaU or paaL where: 

p = micromemory page 
aa = micromemory address 
U/L = Upper / Lower 

A file or main memory address is indicated by adr. 

The term symbol is a location field symbol from the MASS assembly 
listing. 

All commands may be abbreviated by the fewest number of characters that 
make the command unique. If the abbreviation does not make the command 
unique, or if the command is not valid, "COMMAND ERR" is displayed. 
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LOAD Command: 



LOAD T, [MP32] [ , [preset ] [,lfn] ] 



MP32 machine type 

preset hexadecimal value which is put into all micro-memory words 
which are not loaded. 

lfn name of file which contains the binary simulation output 

created by the MASS Assembler; file is rewound before loading. 

Default: LOAD,MP32, 0,SIMFIL 

EXAMPLE: LOAD,MP32,FFFF,LDBIN 

Load the coding to be simulated from a file produced by the MASS Assembler. 
The machine type is selected, "lfn" is rewound and then loaded. Any 
micromemory locations which are not loaded are set to the "preset" hexadecimal 
value. 

Micromemory size is initialized to the loaded microcode length rounded up to 
the next multiple of 512; FILE 1 size is 256, FILE 2 size is 32. The 
assembler symbol table is also loaded for symbol identification. Simulated 
main memory for macro data and instructions is not initialized. Dynamic CYBER 
memory management and allocation is used to ensure that minimum memory is used 
for execution. 

RUN Command: 



RUN 



[ 



t symbol ) 
( mmadr ) 
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Default: Use address from previous execution or 000U if first time. 

EXAMPLE: RUN,12L 

Start the simulation from the indicated micromemory location, the symbolic 
address or continue the simulation. If an address is specified, the 
cumulative simulated execution time is reset to zero. 

SET Command: 

show 

symbol/ J 



1M1UW 
ALL J / value \ \ 



'reg" designation may be any one of the following: 



A,Q,X,F,P,I,N ) K,RTJ,SM1,SM2,M1,M2,IN1,IN2,Y,D,RS,RD 



SHOW lists present contents of all registers. 

ALL sets the A,Q,X,F,P,I,N,K,RTJ, SMI ,SM2,M1 ,M2, INI ,IN2,Y,D,RS,RD 
registers to the value specified or to the symbol addresds. Value is the 
next hexadecimal value to be entered into the register(s); default = 0. 
Symbol is symbol address to be entered into the register(s). 



EXAMPLE: SET,F,02B3 



Set the specified or all the register(s) to "value". The above register 
mnemonics are standard register names, except RS (status) and RD (data) 
which are pseudo registers which hold the status or data to be retrieved 
when INRS or INRD instructions are executed. 
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TRACE Command: 



TRACE, 



OFF 



TRAP 



SHOW 
OFF 

ALL 
type-1 , 



. . type-n 



.TRAP 
[,lim-l, lim-2] [,out] 




SHOW lists current trace or trap settings, 



disables all tracing or trap display. 



ALL enables all trace types for normal or trap. 



specifies type of display when traps are encountered. 



'type" may be any of the following: 



TIME Display microcode execution time and 
addresses of just completed and next 
microinstructions. TIME trace type is 
also enabled with all other trace types. 

REGS Display registers which have changed. 

FILES Display FILE 1 and FILE 2 entries which 
have changed. 

READS Display results of main memory reads. 

WRITES Display results of main memory writes. 
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"lim-1" and "lim-2" are micromemory addresses (mmadr or symbols) and 
define the normal (not TRAP) trace limits; default is "lim-1" = and 
"lim-2" = maximum micromemory. OUT specifies trace only outside the 
limits . 

Defaults: TRACE, REGS, TIME, FILES, READS, WRITES, MM beginning, MM end, 
EXAMPLE: TRACE, REGS, WRITES, 03OU,50L 



© 

© 

TLIM Command: 

f\ TLIM [,num] 

EXAMPLE: TLIM, 295 
© 

^.^ Set/clear the microcode execution time limit. If "num" is not present, the 
\J) time limit will be disabled, "num" is a decimal integer number of 

microseconds . 
O 

BKP Command: 
show 

BKP, ) ALL, CLEAR 
symb 

mmad 



oi r i 

, CLEAR 



SHOW lists current breakpoint settings, 



ALL, CLEAR clears all breakpoints. 

A BKP, mmadr, CLEAR or BKP, symbol, CLEAR clears that breakpoint. I 

A EXAMPLE: BKP,TAG2 



■1 Set or clear breakpoints. Up to 5 breakpoints may be set. Breakpoints always 
stop the simulation just before execution of the address specified and returns 
Jj control to the user; to continue, use RUN. 

© 
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DUMP Command: 



dump, 



MM 



MEM 



MM 

MEM 
Fl 
F2 
PF 

ST 



i.mmadr 
L symbol | 

!, symbol I 
,adr ! 



dump micromemory. 



dump main memory, 



[.words] 



O 

o 
o 

o 



o 



Fl dump FILE 1 entries, 



^y 



w 



F2 



dump FILE 2 entries. 



PF dump page index file entries, 



VV 



v..> 



ST dump program and 8 DMA state registers, 



words hexadecimal number of words to dump, default is 1. 

Starting location or entry (mmadr, symbol, or adr) default is 0. 

EXAMPLE: DUaP,MEM,22, IF 

Dump either memory locations or file entries starting at the address given and 
continuing for the specified number of words. 
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TRAP Command: 

location |~ 



or, 

TRAP , SHOW 

first 



Control 



i r 



{symbol ( 
mmadr? 



.first 



.every .times 



h*™ 8 [{'.STOP/Jj 



■dump* 



MM 



MEM r 




f, words! 



number of times to execute the address before the trap 
occurs; i.e., 3 indicates trap before the third execution of 
the address, "first" is a decimal integer. Default is 1. 



every 



© 




© 
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times 


© 




o 
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GO 


© 


STOP 


© 
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when trapping has started, trap "every" executions of 
the address; i.e., 2 indicates trap every other execution 
of the address. "Every" is a decimal integer. Default 
is 1. 

total number of traps to do. Trap will be removed 
after the 'times' time through the trap, "times" 
is a decimal integer. Default is 100. 

do not stop when trap encountered. 

stop when trap encountered. (TRAP operates as a 
breakpoint) . 
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Dump parameters are the same as for the DUMP command. 
SHOW displays information about currently set traps. 
Default: TRAP,adr,l,l,100,GO 
EXAMPLE: TBAP,LOOP2,10,2,20,STOP,MM,20L,5 



UNTRAP Command: 



I num 

UNTRAP, ALL 



Remove a specific trap or all traps. "Num" is the ordinal number displayed 
when the trap is set, and is also displayed with TRAP, SHOW. 



o 
o 
o 

o 

o 



A trap is set at the given location to either display information defined f\ 

by dump parameters or to return to the operator; control parameters 

specify when and how often the display or return is to be done. Up to (^y 

8 traps may be set. Trapping occurs before execution of the address 

of the trap. The ordinal number of the trap is displayed for use with 

the UNTRAP command. See TRACE command for defining information other 

than dump to be displayed when the trap is encountered. 



w 
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EXAMPLE: UNTRAP, 2 !^ y > 
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PATCH Command: 



PATCH, 



MM 



MEM 

Fl 

F2 

PF 

ST 



mmadr 
symbol 



adr 
symbol 



,value-l,.. . .value-n 



Value -i is hexadecimal value to be placed in indicated or sub- 
sequent location. 

Other parameter definitions are listed under DUMP. 

EXAMPLE: PATCH,MM,30U,FF2,345678F2,0,5AB43 
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Set values into memory locations or file entries. If * is used for the 
address, the first value will be stored in the next sequential address 
following the last value stored on the previous patch command. 

When patching main memory, addresses are absolute. 

ALT IN Command: 



ALTIN 



,lfn LnOEGHOJ TnOREwI 



Default: ALTIN, ALTIN 

EXAMPLE : ALTIN , INFILE , NOECHO 

Read alternate input file lfn until EOR is encountered; lfn is rewound 
before reading unless NOREW is specified. 
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If running interactively and NOECHO is specified, input from the alternate 
file will not be displayed on the terminal. Output resulting from the input 
will be displayed, however. 

DUPOUT Command: 

DUPOUT ,lfn 
EXAMPLE: DUPOUT, 000 



DUPONLY Command: 



DUPONLY 



o 
o 
o 
o. 

© 



Enables/disables duplication of the interactive commands and displays from the 
screen onto a file. The file thus written may later be routed to a printer V^y 1 

for a history of interactive simulation activity. If "lfn" is omitted, ^ 

duplication will be disabled. This command is only active when the simulator V> 

is operated interactively. 



v> 



/*' -> 



V.V 



v^ 



This command enables output to the terminal for the duration of the output v^ 



r~-\ 



from the next command. Output goes only to the DUPOUT file if a DUPOUT 

command has been previously given. The DUPONLY command allows long outputs Mi_y 

like DUMPs to be saved without the information being sent to the interactive 

display. ^^ 

e 

O 
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O SNAP Command: 

SNAP [,lfn] 
Default: SNAP, SNAP 



© 

o 
o 



o 



© 

© 
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EXAMPLE: SNAP.HOLDF 

Capture the current state of the simulation on file lfn. File Ifn 
is rewound before it is written. 



UNSNAP Command: 

[,lfn] 



UNSNAP 



Default: UNSNAP, SNAP 



EXAMPLE : UNSNAP , HOLDF 



Wj) Restore the state of a previous simulation saved with SNAP from file lfn. 

File lfn is rewound before it is read. 
O 

g* HELP Command: 

#|i HELP , command 

EXAMPLE: HELP, LOAD 



Display an example of a particular command to prompt correct use. If 
"command" is omitted or invalid, a complete list of command examples 
will be displayed. 
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CPUTIME Command: 



CPUTIME 



Display the ratio of CYBER cpu time to simulated execution time. 
Timing for ratio determination is re -initialized at each RUN command, 

END Command: 



END 



Exit from the simulator 



DISPLAY MNEMONICS 

This section describes the mnemonics used in display output of the 
registers and other intermediate data. 

Hardware registers: A,Q,X,F,P,I,N,K,RTJ 



Ml = MASK REGISTER 1 

M2 =. MASK REGISTER 2 

I 
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v,y 



Vj" 



v_y 



v.. 

V. 

v 



Other Registers: f'"^ 

SMI = STATUS /MODE 1 (J^ 

SM2 - STATUS /MODE 2 \y 



% y 

c 
o 



o 

o 
o 

© 

o 
o 

fj) D = PERIPHERAL DATA REGISTER 



o 



o 



o 



INI - INTERRUPT REGISTER 1 

IN2 = INTERRUPT REGISTER 2 

BSA = (A) BEFORE SHIFT OR SCALE 

BSQ = (Q) BEFORE A-Q SHIFT OR SCALE 

Y = PERIPHERAL ADDRESS REGISTER 



RS - DATA FOR INPUT BY INRS INSTRUCTION 



RD = DATA FOR INPUT BY INRD INSTRUCTION 



Read Operations: 

Rl - DATA RETRIEVED WITH RDl S -FIELD CODE 



© 
© 

© 

^J) Address Operations for Main Memory: 



R2 = DATA RETRIEVED WITH RD2 S -FIELD CODE 



R3 = DATA RETRIEVED WITH RD3 S -FIELD CODE 



Format is: ATO 

where: A is 1, 2, or 3 for address register. 

T is type of access - W (word), H (half word), 
C (character), or B (bit). 

is operation - R (read) or W (write). 
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WPF = PAGE FILE ADDRESS FOR WRITE 
RPF = PAGE FILE ADDRESS FOR READ 



RSR = STATE REGISTER ADDRESS FOR READ 

CONTROL CARD CALL 



MPSIM 



MPSIM may be operated in batch mode. No parameters are read from the 
control card. Input is taken from file INPUT and output goes to file 
OUTPUT. Input directives are the same as in interactive operation. 
Output is not broken into screen-size blocks as done for interactive 
operation. 

ERROR MESSAGES 



Due to output blocking, interactive terminal 
line length must be 80 columns. 
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WSR - STATE REGISTER ADDRESS FOR WRITE Q} 



o 



./»~\ 

Kj^ 



For interactive operation, there are no parameters associated with the 

control card. Input is obtained from the connected terminal and output ^j 

is directed to the connected terminal (exceptions are ALTIN and DUPOUT 

... . 

commands) • 



~- ^ 



Vv 



Message Command or State 

LINE LEN NOT = 80 Initialization Q 



o 

o 



o 

o 
o 
o 

© 

o 

o 
o 

© 



Message 



COMMAND ERR 



INVALID REG 



ERROR IN TRACE LIMITS. LIMITS SET TO MAX MM. 



MAX BKPTS ALREADY SET 



CANT FIND BKP 



INVALID MEM TYPE 



Command or State 



All 



SET 



TRACE 



BKP 



ADR EXCEEDS FL, DUMP TERMINATED 



BKP, CLEAR 



DUMP or PATCH 



DUMP 



© 
© 

© 



O 



MAX TRAPS ALREADY SET 



PARAM ERROR 



ADR EXCEEDS MEM 



MEM TYPE CHANGE W/* ILLEGAL 



INVALID MACHINE TYPE 



FILE EMPTY 



MMADR EXCEEDS MM SIZE, SIM STOPPED 



ABSOL MEM ADR> MEM INITIALIZED, SIM STOPPED 



TRAP 



UNTRAP 



PATCH 



PATCH 



LOAD 



LOAD 



Execution 



Execution 
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Message 



UNKNOWN SYMBOL OR BAD HEX DIGIT 



MM ADR ERROR 



Command or State 



All 



o 
o 
o 





All 



All or Execution 



Execution 



MPSIM - GO TO ERR, ABORT 

FTN computed goto error processing is not 
used. This message results from a computed 
goto error. 

MPSIM RECOVERED 

Recovery is included so that simulation 
may be stopped with %a (NOS/BE) or 
BREAK(NOS) and so that execution errors 
will not abort the simulation. An addi- 
tional message describing the error is 
generated if the recovery was not caused 
by %a. The program is aborted without 
recovery if running in batch mode. 

INTERACTIVE EXECUTION EXAMPLE 



Figure 6-1 shows interactive terminal input and output for a MASS assembly. 
Figure 6-2 shows the same program being run under MPSIM and the resulting 
output. In both figures, words in lower case are operator entries and upper 
case words are computer generated. 



o 
o 

o 

o 

o 






O 



o 



o 
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The folloning I if^es show temi-ial output for a-i exanple MASS aid MP3IM rui. 



comma 

PFN 
OFMO 
Pr C 
COMMA 
PFN 
MASS 
PF C 
COMMA 
COMMA 
COMMA 
CY3ER 
HFX 
MML 



OIF 
015 



NO- 3ttach,demo, id=gbf . get the microcode source. 
IS 

YCLE NO. = 001 

NO- attach«m3ss, id=col t . get the micro assembler. 

IS 

YCLE NO. = 051 

NO- connect, output. 

NO- screen, 132. 

NO- na55ideB0« output . assemble the source. 

/M=»-60 MICRO ASSEMBLER °SD l/ERSION 1.0 SETPAGE 

HEX CYCLE. LABEL F A 8 S C 

IMAGE COUNT 

IOENT SETPAGE 

OPTN CROSS, L, If MAP, SIMULATE, 



ONE E3U 31 LSB OF WORD = ARITH 1 

ONFK E3U 21 BIT GENERATOR GENERATES $«t00 = 102<»0 



MT 



COMMENTS 



C 



O 

© 

© 

O 

© 



000 U 5807 0000 3 
L 580& 2000 3 

001 U 51.08 0020 3 
L 5805 2000 3 

002 U 5528 002C 3 
L 7115 201F i* 

003 U 5F07 0000 3 
L 5910 E015 5 

00V U 9828 2005 3 

L 9800 2002 3 



005 U 0800 1000 



HEX 
MML 



HEX 
IMAGE 



CYCLE 
COUNT 



♦BEGIN 



PRLOOP 



♦START 



LABEL 



ZERO 
ZERO 
B 
ZERO 

ADO 
A 

A.B 
ZERO 



END 

F 



MICRO MEMORY MAP FOR SETPAGE 

UNUSEO 0005 L 0OFF L 501 
CROSS REFERENCE LISTING FOR SETPASE 
NAME TYPE/VALJE/PAGE 
fIFSIN MA-C/QOOD / 1 
ONE* MA-E/ O'OIS / 
ONE MA-E/001F / 
PPLOOP MA-C/0002 / 
STA»t MA-C/0005 / 
STOP FINIS 

.562 CP SECONDS EXECUTION TIME 
COMMAND- files. 
--LOCAL FILES — 
•T€MO 'MASS SOUTPJT MAPE55 
PUNCH TAPES', 



3TU/0Q0U/ 

9TU/0002L/ 

JJMP/030<fL/ 

JJMP/000<» / 



F 
3G 

BG 

F 







INITALIZE FLAGS 






INITALIZE CHCKSUM 


WS* 




SET CPU STATE = 
INITALIZE (A) 


HPF 




(A) TO PAGE REG ( 


ONE 




INCREMENT A 
SETJP ADDRESS 


ONE< 


ZL 


JPR MEXT IF THRU 


START 


J 


RE-INITALIZE FLAG 


PRLOOP 


J 


3AC< TO LOOP 


N=0 




INDEX TO F2 



MT 



*****#»»»**•»»» 



SIMFIL 



Figure 6-1. Assembly Of DEMO Program Via Terminal 
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COMMAND- attach, mpsim, id=colt. get the nicro simulator. 

PFN IS 

MPSIM 

PF CYCLE NO. = 052 
COMMAND- fflosim. run the nicro simulator. 
LINE LEN NOT =80 

COMMANO- screen, 80. oods, M&SIM needs 80 col screen. 
COMMANO- mosim. run the micro simulator ag3in. 
MPP/MPXX(AMI) SIMULATOR OF 03/22/76 
FIELD LEN 0200673 
?load 

FIELD LEN 0<*5<*763 
FIELD LtN 0211113 

0.168 000U 000L A =00000000 3 =00000000 X =00000000 F =00000000 P =00000000 [1 F, 

I =00000000 N =00000000 K =00000000 RTJOOOOOQQ0 A»=00000000 ^-^ 

x*=oooooooa i»=oooooaoo SMIOOOOOOOO SM20000Q000 Ml=OQOO0000 

M2=00000000 IN100000000 IN200000000 Y =00000000 O =00000003 „^ 

RS=00000000 RD=00000000 ' U L 

0.336 000L C01U 

0.503 001U 001L S1=00000000 S2=00000000 ALJOOOOOOOO WSR0OO0O000 

0.671 001L 002U ^-\ 

0.839 002U 002L S1=00000000 S2=OOOO0000 ALJOOOOOOOO WPF00000000 <^y 

1.063 002L 003U S1=00000000 S2=00000001 A =00000001 
1.231 003J 003L Sl=QOOQO00i F =00000001 
?r ^A 

l.«*55 003L OOttL Sl=00000001 S2=00000!*00 ALJOOOOOOOO [ ^jj 

1.623 G0«*L 002U 

1.791 002J 0C2L Sl=00000001 S2=00000001 ALU00000001 MPF00000001 

2.015 002L 003U 51=00000001 S2=00000001 A =00000002 f "A 

2.183 003U 003L Sl=00000002 F =00000002 ^y 1 

2.1*07 0C3L 00**L 51=00000002 S2=00000<*00 ALJOOOOOOOO 
2.575 00«*L 0C2U 

2.7«»3 002U 002L Sl=00000002 S2=00000002 ALU00000002 WPF00000002 ^ ^ 

2.967 002L 0Q3U Sl=00000002 32=00000801 A =00000003 
3.135 003U 003L Sl=00000003 - =00000003 
3.359 003L 00<*L 51=00000003 S2=O0OO0!*00 ALJOOOOOOOO 
?trace,show 

REGS FILES REAOS WRITES TIME IIM1=000U BEG-MM LIM2=200U ENO-HM V 

?bko,3u 
?bkp,shon r -^ 

003J i 

?r v ~ 7 

3.527 OO'tL 002U 

3.695 002J 002L Sl=00000003 52=00000003 ALJ00000003 WPF00000003 
BKPT ENCOUNTERED 

3.919 002L 003U Sl=00000003 S2=00000001 ALUO0O0O0O<* A = 0000Q00<* Q =00000000 
X =00000000 " =00000003 P =00000000 I =00000000 N =00000000 
K =00000000 RTJOO0OO000 A*=00000000 X»=0OOO0000 Q*=00000000 
SMIOOOOOOOO 3M200000100 M1=00000000 M2=00000000 IN100000000 
IN200000000 Y =00000000 =00000000 RS=00000000 RO=00000000 
?r 

it. 087 003J 003L S1=000Q000<* F = 0000000<* 
<i.311 003L 00<*L S1=0000000£. 32=000001*00 ALJOOOOOOOO '^y 

«*.<*79 00<*L 002U 

«*.6«*7 002U 002L S1=0000000<* S2=0000000<» ALJ0OOO0O0<» WPF00000001* 
BKPT ENCOUNTERET 

«*.871 002L 003U Sl=O000nC0<* 32=00000001 ALU00000005 A =00000005 Q =00000000 
X =00000000 F =0000000"* P =00000000 I =00000000 N =00000000 
K =00000030 STJO00QOOOO A*=00000000 X»=00000000 O*=00000000 

SMIOOOOOOOO SM200000000 M1=00000000 M2=00000000 IN100000000 /T^ 

Y =00000000 D =00000000 RS=OO0O0000 PD=000O000O \j? 



V> : " 



\^' 



IN200000000 
?du*p,pf ,0,8 

000 00000000 000001*01 0000fl<*02 00000003 OOOOO^O!* 00000000 00000000 00000000 
Tend 
COMMAND- 

Figure 6-2. Interactive Execution Of The DEMO Program By The Simulator 
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MASS CONTROL CARD 



%J The MASS control card causes the MASS Assembler to be loaded and executed 

under control of the MPX operating system. This appendix describes the 
parameter options available to the programmer. 



The card format is as follows: 
*MASS(l=u,L=u,P=u,X=u) 

Parameter definitions: 

I=u 

Source input is from logical unit or file u. If =u is absent, 
standard output is assumed. Input must be specified. 

L=u 

Assembly listing is on logical unit or file u. If =u is absent, 

standard output will be used. If this parameter is absent, no 

listing is generated; however, a listing of error lines will be 
output to standard output. 



P=u 

Deadstart binary object output is on logical unit or file u. If =u 
^\ is absent, standard punch is assumed. If P is absent, no binary 



output is generated. 



X=u 



^P Pure binary output is put on logical unit or file u. If =u is 

absent, standard load and go file is assumed. If X is absent, no 
^F binary is generated, u, if present, must specify a disk file or 



magnetic tape unit, 
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EXECUTION ON A CYBER 70/70L/6000 SERIES COMPUTER 



MASS ) p lJ p 2 ,p 3 ,P 4 . 
Pi 



P 2 



P3 



P4 



is the name of the file on which the 
microprogram source resides. The default 
is INPUT. 

is the name of the file on which the assembler 
writes the source listing. The default is OUTPUT. 

is the name of the file on which the assembler 
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The following program call card causes execution of the MASS Assembler \J 

on a CYBER system under NOS or NOS/BE. It assumes the MASS Assembler is 
part of the system library. 



■ o. 

o 



writes the object output. The default is PUNCH. \_J 

is the name of the file on which the assembler 

writes the simulation object output. The 

default is SIMFIL. '\_s 



Example : V_y 

For source cards in the job deck, punch on file DWD, no simulation \^ 

object output, standard listing, the program call card is: 

c 

MASS, ,,DWD. 

c 
c 

c 



o 



o 



o 
o 

© 
© 
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FORMAT OF DEADSTART OUTPUT DECK B 



The deadstart deck contains both the data to be loaded into micromemory and 
control characters to direct the loading. The data is binary generated by 
MASS of a source program and is grouped 4, 32 bit words per card and punched 
in every other column in hollerith. 

The control characters of the deadstart deck are directed to the Function 
Control Register (FCR) , which has access to the CPU similar to the way 
switches on a conventional panel have access to the CPU. Table B-l shows the 
control characters that are issued to the FCR to initialize the files, the 
registers and micromemory. See the BASIC SYSTEM CONTROLLER MODEL 65109 
HARDWARE REFERENCE MANUAL for additional and more detailed information on the 
FCR and the operation of the panel interface. 

The typical load sequence to enter a deadstart deck into the MP32 is to put 
the deadstart deck into the card reader, do a Master Clear and begin loading 
by enabling bit 4 of SM2 (usually connected to a switch). 
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TABLE B-l . DEADSTART DECK FORMAT 



o 



TYPE 



2 
3 
4 
5 
6 
7 



8 
9 



CARDS 



K1008900G 



LOOOOG 
J02G 
LOOOOG 
JOCG 

L 
Data 



MEANING 



JOIG 
LXXXXG 



Set up FCR register. 

Select N register for display 0. 

Select FCR for display 1. 

Select MICRO mode. 

Suppress console transmit. 

Enable micromemory write. 

Clear N register. 

Select K register for display 0. 

Clear K register. 

Select micromemory for display 0. 

Begin load of micromemory. 

Micromemory data in blocks of 256 32-bit micro- 
instructions. Each instruction is terminated 
with a G. The number of instructions per card 
depends on the spacing. 

Select N register for display 0. 

Set N register to the number of 256 instruction 
blocks loaded. 



Card types 5 through 9 are repeated until all full blocks are output. Data 
for the remaining partial block is then punched using cards 5 through 9, 
where card type 7 will contain less than 256 instructions. 



10 



11 



K9A088000G 



K00000000G 



Set up new FCR register. After all data has 
been punched: 

Select RTJ register in display 0. 
Select SM2 register in display 1. 
Select MICRO mode. 
Suppress console transmit. 
Disable micromemory write. 

Clear SM2. This card stops the deadstart hardware 
from reading more cards. Even though the MP 16 
has only 16 bits in the SM2 register, 32 bits of 
zeros (eight characters) are punched on the card 
to ensure total clearing of SM2 in case the 
machine is an MP32. 
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DEFAULT CODES GENERATED FOR BLANK FIELDS 



Each field of the assembly input may be left blank, with the following 
values substituted by MASS: 

Field Default Value 



F A If A field contains a mnemonic and B field blank. 

B If A field is blank and B field contains a mnemonic. 
© ZERO If both A and B fields are blank. 



X 

X 

NOP 

NOP 

00 



M . S If C field is not K= or N=. 
00 If C field is K= or N=. 



T Selected to provide correct sequencing or jumping. 

*L If upper instruction and M field is S or blank. 

^J U If lower instruction and M field is S or blank. 

U If M field is R. 

U If M field is J and C field is constant. 



U If M field is J and C field is a symbol with 
upper quality. 

L If M field is J and C field is a symbol with 
lower quality. 
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\C 



\j/ 
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SELECTING NONCONFLICTING MNEMONICS 



The proper selection of a mnemonic for a field depends on the mnemonics 
used in the other fields (Table D-l. lists permissible combinations or 
codes) . This is an inherent characteristic of the MP and is a result of 
maximizing the information content in the instruction repertoire. This 
means that the most frequently used operands require less space than the 
less frequently used operands. 

TABLE D-l. LEGAL F, A, B, D AND S COMBINATIONS 



F FIELD 


A FIELD 


B FIELD 


D FIELD 


S FIELD 


Arithmetic or logical 


A 


B 


D 


Unused 




A' 


B 


D 


AP 




A 


B' 


D 


BP 




A 


B 


D' 


DP 




A' 


B 


D* 


APDP 




A 


B 


D" 


DPP 




A 


B 


DD 


DD 


Shifts or scale 


b 


b 


b 


Unused 




b 


b 


NOP 


Unused 



Where: b 

A, A', B, B', D, D", DD 
AP, BP, DP, APDP, DPP, DD 



is a blank field 

are types of A, B and D field codes 

are values supplied by the assembler 



Each instruction also consists of a maximum of four independent and con- 
currently executed functional operations; this further reduces the effec- 
tive instruction execution time. Their associated fields are also dual, 
in the sense that they can be used to specify less frequently used operands 
for other fields. The assembler flags ambiguously coded instructions with 
a diagnostic. See Figure D-l for examples of conflicting mnemonics. 
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IA 
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IA 


<t 
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<t 
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IA 
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t- 




1/1 
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lit 


u_ u. 
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<A (A 
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<t CO 
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MASS OUTPUT LISTING 



The output listing produced by MP MASS consists of a side-by-side listing 
of micromemory location, machine language, source card image, error 
codes and sequence number. 

The information is assigned to the following columns of the listing. 

Column Contents and Meaning 

1 Standard print format control. 

2-4 Micromemory location of assembled instruction, 

(MML) 

or value specified in EQU or ORG command. This 

is a three-digit hexadecimal number, with the 

first digit specifying micromemory page and the 

next two digits specifying location within 

the page. 



5 Micromemory overlap indicator. This column is 

4% blank if micromemory location is used only once 

in microprogram. This column contains 1 if 
4% micromemory location had contained information 

previous to assembly of the line of code causing 
m\ overlap. A count of the number of micromemory 

overlaps is included on the last page of 
■J assembly listing for information. 

4% 6 Upper/lower indicator. U specifies that micro- 

instruction is assembled to the upper micro- 

^% instruction of location specified in columns 2 

through 4. L specifies that the microinstruction 

ft is assembled to the lower microinstruction. 

© 

O 17328900-02 E-l 
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Column 

8-16 
(IMAGE) 

19 
(CYCLE) 
COUNT) 



24-103 



104-113 



115 



Contents and Meaning 
Assembled microinstruction in hexadecimal code, 



Timing information. MASS calculates execution 
time for each microinstruction and indicates 
time as the number of minor cycles to execute 
the statement. 

Source card image. 

Sequence number supplied by COSY package (if 
applicable . 

Diagnostic error codes generated by MASS for 
source statement. 



MASS MAP 

MASS will generate a micromemory assignment map if the M(AP) option on 
the OPTN card is specified. The map will show blocks of 256 micromemory 
words (1 micromemory page) where each micromemory word can hold 2 
instructions (an upper and a lower instruction). Asterisks (*) will be 
printed out for each micromemory location assigned and be put in either 
the upper or lower position. Remember also that unless a NOSUM option 
is specified, the checksum of micromemory is placed in the lowest vacant 
memory location, but would not show on the map. 

MASS CROSS-REFERENCE 

MASS will generate a cross-reference table if the C(ROSS) option on the 
OPTN card is specified. The cross-reference listing will contain an 
alphabetic listing of all the labels that occurred within the program. 
Each label will have a set of entries describing what its use was, the 
value associated with it and the page that it appeared on. The label 
use is shown as follows: 
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MA-C 


MICRO ADDRESS 


CODE 


MA-D 


MICRO ADDRESS 


DATA 


MA-0 


MICRO ADDRESS 


ORG 


MA-E 


MICRO ADDRESS 


EQUATE 


MA-S 


MICRO ADDRESS 


SET 


Fl-C 


FILE 1 


CODE 


Fl-D 


FILE 1 


DATA 


Fl-0 


FILE 1 


ORG 


Fl-E 


FILE 1 


EQUATE 


Fl-S 


FILE 1 


SET 


F2-C 


FILE 2 


CODE 


F2-D 


FILE 2 


DATA 


F2-0 


FILE 2 


ORG 


F2-E 


FILE 2 


EQUATE 


F2-S 


FILE 2 


SET 


COND 


CONDITIONAL 




UNKN 


UNKNOWN 




SPCE 


SPACE 




SFLD 


S FIELD 




JUMP 


JUMP 




K= 


K REGISTER = 




N= 


N REGISTER = 




CFLD 


C FIELD 




BTU 


BIT TEST UPPER 




BG 


BIT GENERATOR 




CLO 


CLEAR LOW ORDER 
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SAMPLE LISTING INCLUDING MAP 
AND CROSS REFERENCE 



The following notes are keyed to the fields (columns) of the sample 
listing: 



Note 
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Contents 

Assembler identification; host machine type (CYBER 32/ 
6000/CYBER 70L/CYBER 170), assembler version number. 

Value (in hexadecimal) of the expression on an EQU or 
an ORG card. 

Micromemory location (in hexadecimal) assigned to this 
microinstruction. The HEX MML column contains three 
digits. The first is the page address; the second two 
are the micromemory address within the page. The next 
column specifies U for upper-half word or L for 
lower-half word. 

The contents in hexadecimal of the location. 

A number indicating the length of time in cycles re- 
quired to execute this instruction. (See Basic System 
Controller Model 65109 Hardware Reference Manual.) 

Card image. The fields on the card are indicated by 
the notations: LABEL (location), F, A, B, D, S, C, 
MT and COMMENTS. 

If the assembler detects an error in the information 
coded on the source card, the error code(s) is (are) 
printed on this part of the listing. There is room to 
print up to four error codes on the listing. 
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ASSEMBLY DIAGNOSTICS 



The assembler prints error codes to flag and diagnose incorrect assembly 
statements. When a statement is in error, one to four error codes are 
listed to the right of the statement describing the problem. Figure G-l. 
is an example of a listing containing error codes. 

If any errors occur on a page, the last line printed on the page and all 
subsequent pages of coding contains the message "PREVIOUS ERROR(S) ON 
PAGE n ", where n is the page number of the most recent page to 
contain errors. The final coding page contains the message " n LINES 
CONTAIN ERROR(S)" where n is the total number of all lines containing 
errors, or "NO ERRORS" if no errors were detected. 

MASS ASSEMBLY ERRORS 

The following error codes are generated by MASS: 

Error Code Meaning 

ASF Mnemonic must not be included in A field be- 

cause A field is set by F field (shift or scale). 

AU A field mnemonic is undefined. 

BSF Mnemonic must not be included in B field because 

B field is set by F field (shift or scale). 

BU B field mnemonic is undefined. 

CBC C, B field conflict. B field is N, K, ZERO, or 

N,K; C field must match B field requirement 
for bits 28 and 29. 



17328900-02 G-l 



Error Code 



CER 



o 

o 

Meaning I ■ 

Constant error. Illegal character in HEX, DEC f\ 

or OCT pseudo instruction. 



CMC C and M field conflict. Command desired in C 

field cannot be expressed with instruction se- (f J) 

quencing mode specified in M field. 

CRP Cannot reach page requested. S field must be 

left blank so page jump may be encoded in (j. 



instruction. 



DSC D field requires use of S field, which is already 

set due to a mnemonic in A or B field. 

DU D field mnemonic is undefined. 

ELU Location field in EQU or SET pseudo instruction 

is blank. 

EXP Illegal character, symbol or operator in expression, 

or missing operator. 
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CSC C and S field conflict. The C field requires 

the S field which has already been set by an A, ( J 

B, D or S code or a combination. 

CU C field contains undefined symbol. 

DDS Symbol has been defined more than once, or with 

other than SET pseudo. 
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Error Code 



FBG 



FOV 



FU 



MEM 



MOV 



MU 



OPN 



SAB 



SAS 



su 



TIL 



TNS 



Meaning 

Incorrect number of bits specified in VFD. 

This file location is out of range for the current 
file or was previously defined. If previously 
defined, this instruction does not replace the 
previous one. 

F field mnemonic is undefined. 

Micromemory overflow. 

Micromemory overlap. This micromemory location 
was defined previously. This instruction replaces 
the previous one. This error indication appears 
only if binary output has been selected. 

M field is undefined. 

Illegal option specified on the OPTN card. 

Both A and B fields require use of S field. 

Mnemonic coded for S field cannot be assembled 
because S field is already set by A, B or D field. 

S field contains undefined mnemonic or symbol. 

T field code is illegal for jump command or for 
use in K= or N= command. 

T field must be specified for M field mnemonic R. 
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T field mnemonic is undefined. 
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OTHER DIAGNOSTICS AND INFORMATIVE MESSAGES 



The following messages may appear in the job's dayfile of a CYBER machine; 



o 

o 
o 



A 



REQUESTED FL EXCEEDS USER FL 

BINARY SUPPRESSED — INCREASE FL =42000 + 1000 * HIGHEST PAGE ^jt 

The amount of central memory needed for MASS to produce binary \j> 

output has exceeded the amount that can be requested by the ' 

program. Set the CM parameter on the job card to the value of 
42000, plus the result of 10008 times the sum of the highest 



1> 



■Or\ 



micromemory page number (of 512 words) plus one. \jt 
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MICROINSTRUCTION TIMING 



H 



The basic CPU microinstruction execution time is 168 nanoseconds. Some 
microinstructions have longer execution times to allow certain operations to 
be completed. The microinstructions have been grouped according to execution 
times as requiring 3, 4, 5, 6, 5 + n and 9 56-nanosecond cycles. 

The classification of microinstructions is shown in Figure H-l . This figure 
provides execution time by types for all legal combinations of microcommands 
which extend the basic cycle time. 

Exceptions to the execution time, as listed in Figure H-l, are: 

* The combination of one's complement arithmetic with ADD+ or ADD+T 
arithmetic operation requires four 56-nanosecond cycles. 

* The MMU command is included under read/write micromemory operand 
commands; therefore, it requires nine, rather than four, cycles. 

Analysis of a microprogram for execution time starts by classifying each of 
the microinstructions. This is done by using the microinstruction 
classification table or by examining the assembler output listing. 

Two addressing modes are available for operand references via status mode bit 
113 (SM113) as follows: 

* SMI 13 = - The contents of the combined N/K registers are used to 
reference operands as indicated. The least significant bit of K 
(bit 07) determines which 32-bit half-word is referenced via T' code 
010. 
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H-l 



1 

N REGISTER 
BIT POSITIONS 
00 01 02 i 03 04 05 06 07 



s 



' L 



7~^. 



K REGISTER 
BIT POSITIONS 
00 01 02 03 04 05 06 07 



PAGE 



"N/ — 

MA 



TB 



SMI 13 = 1 - An MA transform via S5 determines the 64-bit word, 
The 32-bit half-word to be referenced must be selected by a T 
field test. 



o 

o. 

o 
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PS REGISTER 




BITS 




XXX 
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\. , 


_> 



PAGE 



SELECTOR S5 




OUTPUT BIT POSITIONS 




00 01 02 03 04 05 06 


07 


x 


/ 



MA 









XXXX = Page in which referencing microinstruction resides. 
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READ/WRITE MICROMEMORY OPERANDS 








SHIFT OR SCALE 






TMA, TMAK, GITMAK, ZL, NU, COL, 




ADD OR SUBTRACT OR 
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1 , B' , NU, ZL, COL, 








ONE'S COMPLEMENT 






INSTRUCTION CYCLES 
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5 + n where n = number 


of shifts 
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9 







N = No 

Y = Yes 

X = Don't Care 



Figure H-l. Microinstruction Classification 
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A field 


o 


ALU 
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A source 
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B field 
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B source 
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Bit test 
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C field 



GLOSSARY 



Definition 

A register. General purpose register that may be shifted 
individually or in conjunction with the Q register. 

Field of MASS input form for specifying input to selector 1. 

Arithmetic logic unit. Capable of performing addition and 
subtraction, as well as logical operations on output of 
selector 1 and selector 2. 

A register, Q register or the combined A/Q register. The 
A and Q registers are shift registers. 

Register or data item selected as output of selector 1. 

Field of MASS input form for specifying input to selector 2. 

Bit generator. Specialized circuitry that generates a value 
consisting of single bit set to 1 with rest of bits set to 0, 

Register or data item selected as output of selector 2. 

Output of selector 7 (located on transform board), which 
allows any specified condition or bits to be used for 
selection of next upper or lower microinstruction. 

Field of MASS input form for specifying instructions, con- 
stants or jump address. 






Deer 



Decrement to reduce contents of a register by one. May 
affect N or K register. 
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Item Definition 

F F register » General purpose, word length register. Note that 

the contents of F will be destroyed when File 1, 2 is accessed. 

F' Holds data for File 3 write. 

F field Field of MASS input form for specifying ALU operation or 
shift or scale operation. 

Fl File 1. 256-word register file, which is addressed by 

contents of K register. 



Input bus Means of transferring information to selector 1 or selector 2. 



IXT Temporary holding register used to decode macroinstructions , 



o 



c. 






o 






F2 File 2. 32-word register file, which is addressed by con- 

tents of N register. Aj? 



,-r ~n 



F3 File 3. High-speed micromemory which is addressed by \_j/ 

the K' or J register. 

I I register. General purpose register; is loaded with output 

of selector 1. ^-^ 

l ncr Increment to increase contents of a register by one. May v_y 

affect N or K register. 

INP Input. One of possible paths of transferring information 

from external devices to selector 4 and thus to selector 2 %_y 

input to ALU. 



~X 



Interrupt A condition that is tested by the microinstruction by use of 

interrupt system, consisting of mask registers and interrupt >0< 
address generator. 
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^% Item Definition 

■™| J J register. Used to address File 3. 

M% K K register. An 8-bit counter that may be set, incremented, 

decremented and tested for zero. Also used to address file 1. 

o 

K 1 Contains image of the K register in the lower 8 bits and 

ffj is also used to address File 3. 

■ J L Holding register for constant increment for J. 

Cj Ll Shift input to a selector; specifies left shift one bit 

position to generate output. 

o 

L8 Shift input to a selector; specifies left shift eight bit 

■j| positions to generate output. 

LAi Main memory lookahead register; i = if DMA lookahead, 

1 to 3 if CPU lookahead. 

LHW Shift input to a selector; specifies left shift a half word, 

end around, to generate output. 

Field of MASS input form for specifying mode of obtaining 
next microinstruction pair. 

Mask register. Word-sized register to control recognition 

of interrupts. An interrupt is recognized if its corresponding 

mask bit of Ml or M2 is set to 1. 

Mask register. Word-sized register to control recognition 
of interrupts. An interrupt is recognized if its cor- 
responding mask bit of Ml or M2 is set to 1. 

MA Micromemory address — used to address micromemory. 

© 
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Item Definition 

MAC Micromemory address counter. Counter that is always updated 

to contain address of next sequential microinstruction pair. 



microinstruction being executed, 
MM Micromemory. 



operation. 
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Q register. General purpose register that may also be used 
in conjunction with A register in shifting. 
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MIR Microinstruction register. Register that holds current V 



o 



N register. An 8-bit counter that may be set, incremented, ^-^ 

decremented and tested for zero. Used as shift and scale *••*' 

counter, used to address file 2 and used to control repeat ^-^' 



AJ 



One's The radix-minus -one complement in binary notation. '^-> / 

Complement 

P P register. General purpose register named P (not a pro- 

gram counter). yy 

P-MA Page-micromemory address register. 12-bit register that v 

contains 4-bit page and 8-bit micromemory address of 
current microinstructions. 

Page Unit of micromemory containing 256 locations of 512 micro- 

structions. 

PS Page number saved of the previous microinstruction 

executed. 



<~\. 
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PTR Paper tape reader. \ iir , 
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RTJ 
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SI 
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Item Definition 



Shift input to a selector; specifies right shift one bit 
position to generate output. 

Read from main memory holding register; i = register 
number from 1 to 3. 

Return register, 12-bit register used to hold a micromemory 
address for returning from micro-subroutine. 

Field of the MASS input form for specifying special operation 
taking place in parallel with other portions of microin- 
struction. 



Selector 1. Selects A input to ALU. 

52 Selector 2. Selects B input to ALU. 

53 Selector 3. Provides shifting of ALU output going to P, A, 
F, X, Q, Fl or F2 destinations. 

54 Selector 4. Selects one of four external inputs to 
selector 6. 

55 Selector 5. Used in performing MA transforms. 

56 Selector 6. Used in selecting source of next microinstruction, 

57 Selector 7, Selects one of the 16 possible bit tests. 

58 Selector 8. Used to select values in K and N transform, 

59 Selector 9. Selects status/mode or mask register for input 
to selector 1. 
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SMI 



SM2 



SRj 



SW 



T field 



TB 



Status/mode 1 register, Status and mode control, 

Status/mode 2 register, Status and mode control, 

State register; j = DMA state registers to 3 and 
CPU state register. 

Console switches, 

Field of MASS input form for specifying selection criteria 
for next microinstruction. 

Test bit — used to identify upper or lower of micro- 
instruction pair, 



o. 















v.y 



Transform 



Two's 
Complement 

WDi 



Facility provided by selector 5 to generate micromemory 
addresses and selector 8 to load K and N registers, 

The radix complement in binary notation, 



Write-to-main-memory holding register; i - register 
number from 1 to 3, 



v,_y 



v.. 



vy 



X register, General purpose word length register. 
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